using-git-worktrees

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

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Syedyasir001/RVULibPass --skill using-git-worktrees-syedyasir001
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/Syedyasir001/RVULibPass/tree/main/.agent/skills/library/using-git-worktrees
Command: npx skills add https://github.com/Syedyasir001/RVULibPass --skill using-git-worktrees-syedyasir001

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 and wastes disk space. This Skill sets up isolated git worktrees so you can develop features in parallel without touching your main 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) to pick a consistent worktree 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 installation, then verifies a clean test baseline before reporting ready. - Use Case: You are about to execute an implementation plan for a new auth feature. The Skill creates .worktrees/auth on a new branch, runs npm install, confirms all 47 tests pass, and hands you a clean isolated workspace. ## Quick Start Ask the AI to set up an isolated git worktree for your new feature branch before starting implementation work.

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. The Skill automates this along with directory selection and setup.

Where should git worktrees be stored in a project?▼

The Skill checks for existing .worktrees or worktrees directories first, then any CLAUDE.md preference, and otherwise asks you to choose between a project-local .worktrees/ folder or a global ~/.config/superpowers/worktrees location.

Why must the worktree directory be gitignored?▼

If a project-local worktree directory is not ignored, its contents can be accidentally tracked and pollute git status. The Skill verifies this with git check-ignore and adds the entry to .gitignore with a commit if missing.

What happens if tests fail in a new worktree?▼

The Skill runs the project's test suite after setup to confirm a clean baseline. If tests fail, it reports the failures and asks whether to proceed or investigate rather than continuing silently.

Does this work with Python or Rust projects, not just Node.js?▼

Yes. The Skill auto-detects the project type from marker files like package.json, Cargo.toml, requirements.txt, pyproject.toml, or go.mod, and runs the matching dependency installation command.