worktree-manager-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

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 |

1. User wants to CREATE a worktree

Keywords: create, new, setup, make, build, start, initialize

Action: Use /create_worktree [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

For step-by-step operation instructions, see [OPERATIONS.md](OPERATIONS.md).

For detailed examples and usage patterns, see [EXAMPLES.md](EXAMPLES.md).

For troubleshooting and common issues, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).

For technical details and quick reference, see [REFERENCE.md](REFERENCE.md).

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