wt-switch-create — Claude Code skill: what it does, how to install
Creates a worktrunk worktree and switches the active session into it, optionally in another repository. Useful when isolating tasks or starting a session in a clean branch.
npx skills add max-sixty/worktrunk --skill wt-switch-create -a claude-codeWhat wt-switch-create does
The skill accepts an optional branch, repository path, and task prompt. If no branch name is provided, the agent derives one from the task description. When creating a worktree in the current repo, uncommitted edits are stashed via git stash push -u and reapplied in the new checkout.
You must have the wt CLI installed locally before using this command. When targeting another repository, the tool invokes wt -C, moves into the destination path, and reads root CLAUDE.md and AGENTS.md files so the agent follows the target repo instructions.
Moving into repos outside approved directories causes Claude Code to reset working directories unless the folder is listed in permissions.additionalDirectories.
What it helps with
- spin up an isolated worktree for a specific task
- switch the agent session into another repository
- transfer uncommitted changes into a newly created branch
- configure branch checkouts without manually typing CLI paths
Example prompts for the agent
- /wt-switch-create my-feature -- fix the parser bug
- /wt-switch-create feature-auth ~/workspace/backend -- update tokens
- /wt-switch-create quick-fix
How to install wt-switch-create
1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill wt-switch-create -a claude-code2Manually: put the files in place
~/.claude/skills/wt-switch-create/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wt-switch-create/
1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill wt-switch-create -a codex2Manually: put the files in place
.agents/skills/wt-switch-create/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill wt-switch-create -a cursor2Manually: put the files in place
.cursor/skills/wt-switch-create/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install max-sixty/worktrunk wt-switch-create2Manually: put the files in place
.github/skills/wt-switch-create/SKILL.md1Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill wt-switch-create -a gemini-cli2Platform CLI
gemini skills install https://github.com/max-sixty/worktrunk --path skills/wt-switch-createManually: put the files in place
.devin/skills/wt-switch-create/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add max-sixty/worktrunk --skill wt-switch-create -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Similar
Questions about wt-switch-create
How to install wt-switch-create in Claude Code?
Run npx skills add max-sixty/worktrunk --skill wt-switch-create -a claude-code.
What does wt-switch-create do?
It provisions a new git worktree with worktrunk and points the current coding session to that checkout.
What are the prerequisites for wt-switch-create?
You must have the wt CLI installed. Without it, worktree commands fail immediately.
