worktree
Create a git worktree and prime the development environment for a new feature or refactor
SKILL.md.claude/skills/worktree
GitHubCreate Git Worktree
Create a new git worktree for isolated feature development.
Instructions
- Parse the branch name from arguments
- Run the worktree creation script
- Report the result and next steps
Execution
The script always creates a new branch from current HEAD, places the worktree under trees/<name> (gitignored, so it never pollutes git status/diff/search), and primes it (pnpm install, shared build, env files):
scripts/create-worktree.sh <branch-name>
Branch Naming Convention
If the user provides just a feature name without a prefix, add the appropriate prefix:
- Features:
feat/<name>(default) - Refactors:
refactor/<name>(if user mentions "refactor") - Fixes:
fix/<name>(if user mentions "fix" or "bug") - Chores:
chore/<name>(if user mentions "chore")
Examples
| User Input | Branch Name |
|---|---|
/worktree new-feature |
feat/new-feature |
/worktree refactor auth |
refactor/auth |
/worktree fix/login-bug |
fix/login-bug (keep as-is) |
/worktree feat/my-thing |
feat/my-thing (keep as-is) |
After Execution
Tell the user:
- The worktree location
- How to navigate to it:
cd <worktree-path> - Remind them to start a new agent session (Claude Code or Codex) in that directory for isolated work
Arguments
$ARGUMENTS