using-git-worktrees

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

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/macintorsten/aurapod --skill using-git-worktrees-macintorsten
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/macintorsten/aurapod/tree/main/.github/skills/using-git-worktrees
Command: npx skills add https://github.com/macintorsten/aurapod --skill using-git-worktrees-macintorsten

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 feature work proceeds without touching your main checkout, while preventing common mistakes like committing worktree contents or starting from a broken baseline. ## Core Features & Use Cases - Smart Directory Selection: Follows a priority order of existing .worktrees or worktrees directories, CLAUDE.md preferences, then user prompt to pick a consistent location. - Safety Verification: Checks with git check-ignore that project-local worktree directories are ignored, and fixes the .gitignore before proceeding if they are not. - Automated Setup and Baseline Tests: Auto-detects project type (Node.js, Rust, Python, Go), installs dependencies, and runs the test suite to confirm a clean starting point. - Use Case: You are mid-review on one branch when a new feature is approved. Use this Skill to spin up an isolated worktree on a new branch, install dependencies, and verify all tests pass before implementing. ## Quick Start Set up an isolated git worktree for the new authentication feature branch and verify the test baseline is clean.

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. Then change into that directory and install project dependencies before starting work.

Where should git worktrees be stored in a project?▼

Prefer an existing .worktrees or worktrees directory in the project, with .worktrees winning if both exist. If neither exists, check CLAUDE.md for a stated preference, otherwise ask the user or use a global location outside the repository.

Why do git worktree contents show up in git status?▼

This happens when the worktree directory is not listed in .gitignore. Verify with git check-ignore before creating the worktree, and if it is not ignored, add the directory to .gitignore and commit that change first.

Should I run tests after creating a git worktree?▼

Yes, run the project's test suite immediately after setup to confirm a clean baseline. If tests fail, report the failures and ask whether to proceed, since otherwise you cannot distinguish new bugs from pre-existing issues.

Can git worktrees work with Node, Rust, Python, and Go projects?▼

Yes, setup is auto-detected from project files: npm install for package.json, cargo build for Cargo.toml, pip or poetry install for Python files, and go mod download for go.mod. Projects without these files skip dependency installation.