What problem does it solve?
This Skill eliminates the risk of conflicting changes, messy workspace states, and accidental branch pollution when working on multiple features, bug fixes, or experimental changes in the same Git repository, keeping your main working branch clean and stable.
Core Features & Use Cases
- Automatic Isolation Detection: Checks if you are already in an existing linked worktree or git submodule before creating a new workspace to avoid nested or redundant worktrees.
- Native Tool Prioritization: Uses platform-native worktree creation tools first for seamless integration with your development environment, falling back to manual git worktrees only when no native tool is available.
- Safety Guardrails: Automatically verifies that project-local worktree directories are added to .gitignore to prevent accidental commits of worktree contents, and falls back to working in the current directory if sandbox permissions block worktree creation.
- Use Case: If you are starting work on a new billing feature for the Ventura Dental clinic management system, this Skill will set up a dedicated isolated workspace so your changes do not interfere with ongoing work on the patient appointment scheduling module.
Quick Start
Use the using-git-worktrees skill to set up an isolated workspace for your new feature branch before you start writing any implementation code.