Manages git worktrees to enable context switching without stashing changes or changing branches in one directory.
Install
mkdir -p .claude/skills/worktree-manager-skill && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1251" && unzip -o skill.zip -d .claude/skills/worktree-manager-skill && rm skill.zipInstalls to .claude/skills/worktree-manager-skill
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
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.Key capabilities
- →Initialize a new parallel worktree from a branch
- →List all current active worktree environments
- →Automated cleanup of temporary development directories
- →Manage parallel isolated environments with custom ports
How it works
Wraps standard git worktree commands into an interface that handles filesystem directory management and cleanup.
Inputs & outputs
When to use worktree-manager-skill
- →Create a new parallel feature branch
- →List all active worktrees
- →Cleanup old worktree environments
- →Check configuration status of a workspace
About this skill
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
When not to use it
- →When a single branch working directory is sufficient
- →When the project does not use git
Prerequisites
Limitations
- →May conflict with build tools that hardcode file paths
- →Creating too many worktrees can consume disk space
How it compares
It abstracts the git worktree command syntax into a simplified management layer for easier parallel development.
Compared to similar skills
worktree-manager-skill side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| worktree-manager-skill (this skill) | 4 | 9mo | No flags | Beginner |
| resolve-conflicts | 81 | 8mo | Review | Intermediate |
| openspec-onboard | 10 | 6mo | Review | Beginner |
| codex-cli-bridge | 9 | 9mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by disler
View all by disler →You might also like
resolve-conflicts
antinomyhq
Use this skill immediately when the user mentions merge conflicts that need to be resolved. Do not attempt to resolve conflicts directly - invoke this skill first. This skill specializes in providing a structured framework for merging imports, tests, lock files (regeneration), configuration files, and handling deleted-but-modified files with backup and analysis.
openspec-onboard
studyzy
Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
codex-cli-bridge
alirezarezvani
Bridge between Claude Code and OpenAI Codex CLI - generates AGENTS.md from CLAUDE.md, provides Codex CLI execution helpers, and enables seamless interoperability between both tools
skill-sync
KyleKing
Syncs Claude Skills with other AI coding tools like Cursor, Copilot, and Codeium by creating cross-references and shared knowledge bases. Invoke when user wants to leverage skills across multiple tools or create unified AI context.
github-workflow-automation
ruvnet
Advanced GitHub Actions workflow automation with AI swarm coordination, intelligent CI/CD pipelines, and comprehensive repository management
git-advanced-workflows
wshobson
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.