Skills conductor-revert
📦

conductor-revert

Safe ⚙️ External commands

Revert git changes by logical work unit

Safely undo git commits by track, phase, or task with full history preservation. This skill provides structured revert workflows with explicit confirmation and conflict detection.

Supports: Claude Codex Code(CC)
📊 71 Adequate
1

Download the skill ZIP

2

Upload in Claude

Go to Settings → Capabilities → Skills → Upload skill

3

Toggle on and start using

Test it

Using "conductor-revert". Revert task 2.3 in auth_20250115

Expected outcome:

REVERT EXECUTION PLAN

Target: Task 2.3 in auth_20250115

Commits to revert (in reverse chronological order):
1. abc1234 - feat: add OAuth callback handler (auth_20250115)
2. def5678 - chore: mark task 2.3 complete (auth_20250115)

Files that will be affected:
- src/auth/oauth.ts (will be deleted)
- src/routes/callback.ts (will be deleted)
- conductor/tracks/auth_20250115/plan.md (modified)

Plan updates:
- Task 2.3: [~] -> [ ]

!! WARNING !!
This operation will:
- Create 2 revert commits
- Modify 3 files
- Reset 1 task to pending status

Type 'YES' to proceed, or anything else to cancel:

Using "conductor-revert". Revert phase 1 in dashboard_20250112

Expected outcome:

REVERT EXECUTION PLAN

Target: Phase 1 in dashboard_20250112 (Tasks 1.1 through 1.4)

Commits to revert (in reverse chronological order):
1. ghi9012 - feat: add dashboard export (dashboard_20250112)
2. jkl3456 - chore: mark task 1.4 complete (dashboard_20250112)
3. mno7890 - feat: add chart filters (dashboard_20250112)
4. pqr1234 - chore: mark task 1.3 complete (dashboard_20250112)
5. stu5678 - feat: add data hooks (dashboard_20250112)
6. vwx9012 - chore: mark task 1.2 complete (dashboard_20250112)
7. yza3456 - feat: add chart rendering (dashboard_20250112)
8. bcd7890 - chore: mark task 1.1 complete (dashboard_20250112)

Type 'YES' to proceed, or anything else to cancel:

Quality Score

38
Architecture
100
Maintainability
87
Content
31
Community
100
Security
91
Spec Compliance

What You Can Build

Undo a failed feature implementation

Revert all commits for a specific task that introduced bugs or did not meet requirements

Restore previous working state

Revert an entire phase of work to return to a known good state before a major refactor

Clean up experimental work

Remove all traces of an experimental track that was not merged to production

Try These Prompts

Revert a specific task
Revert task 2.3 in the auth_20250115 track. Show me what commits will be affected and confirm before proceeding.
Revert an entire phase
Revert phase 2 of the dashboard_20250112 track. I want to see the full plan with all affected files before confirming.
Interactive revert selection
Help me revert some recent work. Show me the available tracks and tasks I can revert.
Full track removal
Revert the entire experiment_20250120 track. This experimental feature was not approved and needs to be fully removed from history.

Best Practices

  • Always review the full execution plan before confirming any revert operation
  • Run tests after revert completion to verify the application works correctly
  • Communicate with your team before reverting shared or reviewed work

Avoid

  • Do not use this skill to hide mistakes from team members - discuss issues openly
  • Avoid reverting work that others have built upon without coordination
  • Do not skip the explicit confirmation step - always review the plan first

Frequently Asked Questions

What is the difference between git revert and git reset?
Git revert creates new commits that undo previous changes while preserving history. Git reset removes commits entirely, rewriting history. This skill uses only git revert for safety and audit trails.
Can I revert commits that have already been pushed to remote?
Yes. Reverting pushed commits creates new revert commits that you can safely push. This is the recommended approach over force pushing, which can cause problems for collaborators.
What happens if a merge conflict occurs during revert?
The skill halts immediately and displays conflict details. You must manually resolve conflicts before continuing. The skill preserves completed reverts and provides guidance for resolution.
Can I undo a revert if I made a mistake?
Yes. You can run git revert on the revert commits to restore the original changes. The skill provides undo instructions in the verification output.
What if the skill cannot find commits for my track?
This may mean the track was never committed, or commits used a different naming format. The skill will offer to delete the track directory or cancel the operation.
Does this skill modify my plan.md automatically?
Yes. After successful git reverts, the skill updates plan.md to mark reverted tasks as pending. These changes are not committed - they reflect the new state of your work.

Developer Details

File structure

📄 SKILL.md