worktrunk — Claude Code skill for git worktree management
This skill gives an AI agent a reference for the wt CLI: which worktree a command touches, what lives in each config file, how hooks run.
npx skills add max-sixty/worktrunk --skill worktrunk -a claude-codeWhat worktrunk does
Worktrunk is a command-line tool for git worktrees, and this skill hands the agent its documentation. The bundled reference/ files cover configuration, hooks, the switch, merge and list commands, LLM commit messages, aliases and troubleshooting. The agent pulls them in when it needs to know which worktree a wt command will act on, or when it edits .config/wt.toml and ~/.config/worktrunk/config.toml.
One rule the skill keeps coming back to: a branch argument already names its worktree, while the global -C <path> moves the working directory instead of picking a worktree. Combining the two names the same worktree twice. The configs differ in how carefully you should touch them. User config in ~/.config/worktrunk/config.toml never lands in git, so the skill suggests proposing a change and getting consent first. Project config at <repo>/.config/wt.toml is versioned, which makes edits there easier to undo.
The skill needs the wt CLI installed, otherwise the example commands go nowhere. Project hooks also do not fire on their own in non-interactive sessions — Worktrunk waits for the user to approve them, so do not count on an unattended run.
What it helps with
- figure out which worktree a
wtcommand targets - write a hook for a worktree lifecycle event
- set up LLM commit message generation
- keep user and project configs separate by permission
- build an alias or multi-step
wtpipeline
Example prompts for the agent
- Explain which worktree
wt switch betawill pick when I run it from another one - Add a
pre-starthook to.config/wt.tomlthat runsnpm install - Set up commit message generation in my worktrunk user config
How to install worktrunk
1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a claude-code2Manually: put the files in place
~/.claude/skills/worktrunk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/worktrunk/
1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a codex2Manually: put the files in place
.agents/skills/worktrunk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a cursor2Manually: put the files in place
.cursor/skills/worktrunk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install max-sixty/worktrunk worktrunk2Manually: put the files in place
.github/skills/worktrunk/SKILL.md1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a gemini-cli2Platform CLI
gemini skills install https://github.com/max-sixty/worktrunk --path skills/worktrunkManually: put the files in place
.devin/skills/worktrunk/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill worktrunk -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about worktrunk
How do I install worktrunk in Claude Code?
Run npx skills add max-sixty/worktrunk --skill worktrunk -a claude-code. The skill lands at ~/.claude/skills/worktrunk/SKILL.md.
What does the worktrunk skill do?
It gives the agent a reference for the wt CLI: config files, hook types, commands and alias recipes. The agent loads it when editing worktrunk configuration or debugging wt behavior.
What does the skill need to work?
The wt CLI has to be installed, since every example builds on it. Project hooks in non-interactive sessions wait for user approval.
