What problem does it solve?
This Skill removes the friction of manually creating and configuring isolated git workspaces for feature development, eliminating the risk of branch conflicts, accidental changes to your active workspace, and inconsistent project setup across parallel workstreams.
Core Features & Use Cases
- Convention-aware directory selection: Automatically prioritizes existing project-local worktree directories, checks project-specific preferences in CLAUDE.md, or prompts you for a location if no convention exists.
- Safety-first verification: Ensures project-local worktree directories are added to .gitignore before creation to prevent accidental tracking of worktree contents.
- Automated setup and validation: Auto-detects project dependencies (Node.js, Rust, Python, Go) to run installation, then verifies a clean test baseline before you start work.
- Use Case: If you are implementing a new payment processing feature, this Skill will automatically set up an isolated worktree, install project dependencies, run tests to confirm no pre-existing failures, and notify you when the workspace is ready for coding.
Quick Start
Use the worktree skill to set up an isolated workspace for implementing the new payment processing feature.