using-git-worktrees

Create isolated Git worktrees with safe directory selection and baseline validation.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/51hhh/BU03 --skill using-git-worktrees-51hhh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/51hhh/BU03/tree/main/.github/skills/using-git-worktrees
Command: npx skills add https://github.com/51hhh/BU03 --skill using-git-worktrees-51hhh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction and risk of starting feature work in a shared checkout by creating an isolated Git worktree with the right branch and location.

Core Features & Use Cases

  • Smart Directory Selection: Chooses an existing .worktrees/ or worktrees/ directory when present, otherwise checks project guidance before asking the user.
  • Safety Verification: Ensures project-local worktree directories are ignored by Git before creating anything that could pollute the repository.
  • Baseline Validation: Sets up dependencies and runs the project’s tests so you know the workspace is ready before implementation begins.
  • Use Case: Start a new feature branch without disturbing your current changes, then confirm the workspace is clean and ready to code.

Quick Start

Use the using-git-worktrees skill to create an isolated worktree for my current feature and confirm it is safe, set up, and ready to use.

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 an isolated git worktree for parallel branch development?

Creating an isolated git worktree involves choosing a safe directory location, verifying project gitignore rules, and checking out the target feature branch separately to prevent conflicts with your current workspace.

What is the safest way to set up a git workspace for feature work?

The safest way to set up a git workspace is enforcing gitignore rules for project-local worktree directories, verifying existing paths, and checking CLAUDE.md preferences before creating the isolated branch.

How do git worktrees prevent polluting the repository during feature development?

Git worktrees prevent repository pollution by verifying that project-local worktree directories are explicitly ignored by Git before creating any new isolated workspaces for parallel branch development.

Can I run baseline tests automatically after setting up a new git worktree?

Yes, you can run baseline tests automatically after setting up a git worktree. The skill configures dependencies and executes the project's test suite to validate workspace readiness before implementation begins.

Do I need to manually choose a directory location for my git worktree?

You do not need to manually choose a directory location for your git worktree. The skill smartly selects an existing `.worktrees/` directory or checks project guidance before prompting you.

What are the limitations of using project-local worktrees for branch isolation?

A key limitation of project-local worktrees is the risk of repository pollution if the worktree directory is not properly ignored by Git, which the skill mitigates by enforcing strict gitignore safety checks.