using-git-worktrees
Use when starting feature work that needs isolation from current workspace or before executing implementation plans. Creates isolated git worktrees with smart directory selection and safety verification.
📖 中文导读:Use when starting feature work that needs isolation from current workspace or before executing implementation plans. Creates isolated git worktrees with smart directory selection and safety verification. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: using-git-worktrees description: Use when starting feature work that needs isolation from current workspace or before executing implementation plans. Creates isolated git worktrees with smart directory selection and safety verification. allowed-tools: Read, Bash, Grep, Glob
Git Worktrees
Git worktrees create isolated workspaces sharing the same repository, allowing work on multiple branches simultaneously.
Announce at start: "I'm using the using-git-worktrees skill to set up an isolated workspace."
Quick Start
# Create worktree with new branch
git worktree add .worktrees/feature-auth -b feature/auth
# Create worktree from existing branch
git worktree add .worktrees/bugfix bugfix/issue-123
# List worktrees
git worktree list
# Remove worktree
git worktree remove .worktrees/feature-auth
Directory Selection
- Check existing:
.worktrees/orworktrees/ - Check CLAUDE.md for preference
- Ask user if neither exists
Safety Requirements
Before creating project-local worktree:
# Verify directory is in .gitignore
grep -q "^\.worktrees/$" .gitignore || grep -q "^worktrees/$" .gitignore
If NOT in .gitignore: Add it immediately and commit.
References
- WORKFLOW.md - Detailed workflow steps
- scripts/ - Helper scripts