Agent skill
wt-prune
Clean up stale git worktree references and metadata. Use when git shows worktrees that no longer exist, or after manually deleting worktree directories. Fixes inconsistencies.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/wt-prune
SKILL.md
/wt:prune - Prune Stale Worktree References
Description
Quick command to clean up stale worktree administrative files and references.
Usage
/wt:prune
What It Does
This slash command:
- Runs
git worktree pruneto remove stale worktree metadata - Cleans up references to worktrees that no longer exist on disk
- Shows what was cleaned up
When to Use
Use /wt:prune when:
- You manually deleted a worktree directory (without using git commands)
- Git shows worktrees that don't actually exist anymore
- You want to clean up orphaned worktree references
- After moving or renaming worktree directories
Workflow
The command will:
- Check for stale references - Find worktrees that don't exist on disk
- Show what will be pruned - List stale references
- Run prune command - Execute
git worktree prune - Confirm cleanup - Show what was removed
Benefits
✅ Clean Metadata - Removes orphaned references ✅ Fix Inconsistencies - Resolves git worktree list issues ✅ Safe Operation - Only removes references, not actual files ✅ Quick Fix - Solves common worktree problems
Notes
- This command is safe - it only removes metadata, not actual files
- If you manually deleted a worktree directory, this cleans up git's records
- Different from
/wt:cleanupwhich removes actual worktrees - Automatically run as part of
/wt:cleanup
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?