using-git-worktrees

Create and manage isolated Git worktrees with gitignore checks.

2|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/anortham/razorback --skill using-git-worktrees-anortham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/anortham/razorback/tree/main/skills/using-git-worktrees
Command: npx skills add https://github.com/anortham/razorback --skill using-git-worktrees-anortham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Git worktrees create isolated workspaces that share the same repository, enabling feature development without disrupting the main working tree.

Core Features & Use Cases

  • Detects existing worktree directories (.worktrees or worktrees) and uses them when possible.
  • Honors preferences from CLAUDE.md and prompts when a decision is needed.
  • Verifies gitignore compliance to prevent accidentally committing worktree content.

Quick Start

Ask me to set up an isolated worktree for feature development in the current repository.

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 feature development?

To create an isolated Git worktree, the Skill detects existing directories like .worktrees or prompts you for a destination, verifies gitignore compliance, and executes deterministic path resolution to report post-creation readiness safely.

What are Git worktrees and when do I need them for branch management?

Git worktrees are isolated workspaces sharing the same repository, needed when you want to develop features without disrupting the main working tree or altering your current project setup.

How do I prevent accidentally committing Git worktree directories?

You can prevent accidental commits by verifying gitignore compliance before creation, which the Skill checks automatically to ensure your worktree content is excluded from repository tracking.

Can I use CLAUDE.md to configure Git worktree directory preferences?

Yes, the Skill honors directory preferences specified in CLAUDE.md and will prompt you to choose a destination directory only when a decision is needed for worktree placement.

Does this Git worktree setup work with existing local repositories?

Yes, you can apply this to local repositories with existing directory preferences, detecting folders like .worktrees or worktrees automatically to integrate seamlessly with your current project setup.

What's the best way to manage multiple feature branches without altering the main workspace?

Using Git worktrees is the best way to isolate feature development, creating separate workspaces that share the repository while keeping your main working tree completely undisturbed.