What problem does it solve?
When working on multiple concurrent tasks (such as feature development and critical bug fixes) in the same git repository, constant branch switching creates messy workspaces, risks accidental changes to unrelated work, and wastes time re-setting up environments. This Skill eliminates that friction by enabling parallel work in fully isolated, dedicated workspaces.
Core Features & Use Cases
- Automated Isolated Workspace Creation: Leverages git worktrees to let you work on multiple branches simultaneously without switching, keeping your main workspace clean.
- Smart Directory Selection: Automatically follows project-existing worktree directories, respects CLAUDE.md preferences, or prompts you for input if no convention is in place.
- Built-in Safety Guardrails: Verifies worktree directories are ignored by git to prevent accidental commits of worktree contents, and auto-adds and commits the necessary gitignore entry if missing.
- Use Case: For example, if you are mid-way through a large feature implementation and need to fix a critical production bug, use this Skill to create an isolated worktree for the bug fix without disrupting your current feature work or losing progress.
Quick Start
Use the using-git-worktrees skill to set up an isolated worktree for your current feature branch, following your project's directory preferences and safety checks.