using-git-worktrees

Creates isolated git worktrees with directory selection, ignore verification, and baseline test validation.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/NT-boop-star/BRMV-tract --skill using-git-worktrees-nt-boop-star
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/NT-boop-star/BRMV-tract/tree/main/antigravity/skills/using-git-worktrees
Command: npx skills add https://github.com/NT-boop-star/BRMV-tract --skill using-git-worktrees-nt-boop-star

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working on multiple branches simultaneously often requires stashing changes or cloning the repository again, which disrupts your current workspace. This Skill sets up isolated git worktrees so you can start feature work or execute implementation plans without touching your existing checkout. ## Core Features & Use Cases - Smart Directory Selection: Follows a priority order—existing .worktrees/ or worktrees/ directories, then CLAUDE.md preferences, then asking the user—so worktrees land in a consistent location. - Safety Verification: Checks with git check-ignore that project-local worktree directories are gitignored before creation, and fixes the .gitignore automatically if not. - Automated Project Setup: Auto-detects Node.js, Rust, Python, or Go projects and runs the appropriate dependency install, then runs the test suite to verify a clean baseline. - Use Case: Before executing an implementation plan for a new auth feature, use this Skill to create .worktrees/auth on a new branch, install dependencies, and confirm all 47 existing tests pass before writing any code. ## Quick Start Set up an isolated git worktree for my new feature branch and verify the project tests pass before I start implementing.

Frequently Asked Questions about using-git-worktrees

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a git worktree for a new feature branch?

Run git worktree add with a target path and the -b flag to create a new branch, for example git worktree add .worktrees/auth -b feature/auth. This Skill automates path selection, branch creation, and dependency setup in one flow.

Where should git worktrees be stored in a project?

This Skill checks for an existing .worktrees or worktrees directory first, then any CLAUDE.md preference, then asks you to choose between a project-local .worktrees/ folder or a global ~/.config/superpowers/worktrees/<project>/ location.

Why must the worktree directory be in .gitignore?

If a project-local worktree directory is not ignored, its contents appear in git status and can be accidentally committed. The Skill runs git check-ignore before creation and adds the entry to .gitignore with a commit if it is missing.

Does this work with Python, Rust, or Go projects?

Yes, the setup step auto-detects the project type from marker files: package.json triggers npm install, Cargo.toml triggers cargo build, requirements.txt or pyproject.toml trigger pip or poetry install, and go.mod triggers go mod download.

What happens if baseline tests fail in a new worktree?

The Skill reports the test failures and asks whether to proceed or investigate rather than continuing silently. This prevents confusing pre-existing failures with bugs introduced by your new changes.