worktree-manager-skill
Comprehensive git worktree management. Use when the user wants to create, remove, list, or manage worktrees. Handles all worktree operations including creation, deletion, and status checking.
When & Why to Use This Skill
The Worktree Manager Skill provides a comprehensive solution for Git worktree lifecycle management, enabling developers to maintain parallel development environments with ease. It automates the complexities of environment isolation, including port offsets and database configurations, allowing for seamless context switching without the overhead of manual Git commands or branch stashing.
Use Cases
- Parallel Feature Development: Create isolated worktrees to work on multiple features or branches simultaneously without needing to stash, commit, or switch contexts in a single directory.
- Concurrent Testing and Debugging: Run different versions of an application side-by-side with automated port management to compare behaviors or reproduce bugs in a clean environment.
- Rapid Hotfix Deployment: Quickly spin up a dedicated worktree to address urgent production issues while keeping your primary development workspace undisturbed.
- Workspace Optimization: Efficiently list and audit active worktrees to clean up stale environments and reclaim system resources through automated removal commands.
| name | worktree-manager-skill |
|---|---|
| description | Comprehensive git worktree management. Use when the user wants to create, remove, list, or manage worktrees. Handles all worktree operations including creation, deletion, and status checking. |
| allowed-tools | SlashCommand, Bash, Read, Write, Edit, Glob, Grep |
Worktree Manager Skill
Complete worktree lifecycle management for parallel development environments with isolated ports, databases, and configuration.
When to use this skill
Use this skill when the user wants to:
- Create a new worktree for parallel development
- Remove an existing worktree
- List all worktrees and their status
- Check worktree configuration or status
- Manage multiple parallel development environments
Do NOT use this skill when:
- User asks for a specific subagent or skill delegation
- User wants to manually use git commands directly
- The task is unrelated to worktree management
Operations Overview
This skill manages three core worktree operations:
| Operation | Command | When to Use |
|---|---|---|
| Create | /create_worktree |
User wants a new parallel environment |
| List | /list_worktrees |
User wants to see existing worktrees |
| Remove | /remove_worktree |
User wants to delete a worktree |
Decision Tree: Which Command to Use
1. User wants to CREATE a worktree
Keywords: create, new, setup, make, build, start, initialize
Action: Use /create_worktree <branch-name> [port-offset]
2. User wants to LIST worktrees
Keywords: list, show, display, what, which, status, check, view
Action: Use /list_worktrees
3. User wants to REMOVE a worktree
Keywords: remove, delete, cleanup, destroy, stop, kill, terminate
Action: Use /remove_worktree <branch-name>
Quick Start
For step-by-step operation instructions, see OPERATIONS.md.
For detailed examples and usage patterns, see EXAMPLES.md.
For troubleshooting and common issues, see TROUBLESHOOTING.md.
For technical details and quick reference, see REFERENCE.md.
Important Notes
Do NOT attempt to:
- Create worktrees manually with git commands
- Manually configure ports or environment files
- Use bash to remove directories directly
- Manage worktree processes manually
Always use the slash commands because they:
- Handle all configuration automatically
- Ensure port uniqueness
- Validate operations
- Provide comprehensive error handling
- Clean up properly on removal