What problem does it solve?
Git workflows that require working on multiple branches simultaneously risk workspace contamination, accidental commits, and fragile branch switching; this skill provides a reproducible way to create isolated worktrees and enforce safety checks so implementation work begins from a clean baseline.
Core Features & Use Cases
- Directory selection with priority: Detects and prefers .worktrees over worktrees, checks CLAUDE.md for configured preferences, and prompts the user when no preference exists.
- Safety verification and remediation: Ensures project-local worktree directories are git-ignored, can add and commit .gitignore entries when missing, and prevents accidental tracking of worktree contents.
- Automated creation and setup: Creates branch-backed worktrees, auto-runs dependency installs and builds based on common project files (package.json, Cargo.toml, pyproject.toml, go.mod), and runs tests to verify a clean baseline before proceeding.
- Use case: Start isolated feature work for Node, Python, Go, or Rust projects to implement changes without switching or contaminating your primary workspace.
Quick Start
Use the using-git-worktrees skill to create a verified, ignored project-local worktree for branch feature/auth, run the project's setup, and validate that tests pass before starting implementation.