handoff-to-worktree
Installation
SKILL.md
Handoff to worktree
Packages context (the whole chat, or a specific issue/topic) into a self-contained
handoff file in the OS temp dir, and for each handoff launches a fresh claude
with its own meaningfully named git worktree and an opening prompt that loads the
handoff and continues the work. No manual copy-paste of context.
Permissions — inherit the caller, never hardcode a bypass. The child claude must run with the SAME permission posture as the session this skill runs in. If the caller bypasses permissions, the child does too; if the caller runs in normal (prompted) mode, the child prompts too. See step 4 for how to detect it.
Placement (where the child claude opens):
- Default — a new workspace per handoff (
cmux new-workspace --command …). Each handoff is its own workspace in the sidebar. --tabs— new tabs in the current workspace. When the user says "in the same / in this workspace", "as tabs", or passes--tabs, open each handoff as a new terminal surface (tab) in the caller's workspace (new-surface+sendsend-key Enter, see step 4b).