using-git-worktrees

Create isolated git worktrees with safety checks and directory discovery.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/jmmL/dr3-old --skill using-git-worktrees-jmml
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/jmmL/dr3-old/tree/main/.claude/skills/using-git-worktrees
Command: npx skills add https://github.com/jmmL/dr3-old --skill using-git-worktrees-jmml

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of isolated git worktrees to enable feature work without affecting the active workspace. It provides a safe, repeatable way to branch work without polluting the main development environment.

Core Features & Use Cases

  • Directory selection and priority resolution: checks existing directories (.worktrees, worktrees), CLAUDE.md preferences, and prompts the user when needed.
  • Safety verification: ensures the chosen directory is ignored by git to prevent accidentally committing worktree contents.
  • Automatic worktree creation and setup: determines the correct path for project-local or global worktrees, creates the worktree on the new branch, and runs basic project setup.

Quick Start

Use the using-git-worktrees skill to set up an isolated workspace.

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, this skill automates branching and directory setup, checking existing paths and CLAUDE.md preferences to establish a safe, separate workspace without contaminating your active environment.

Why should I use git worktrees instead of standard branching?

Git worktrees provide isolated directories for each branch, preventing workspace contamination. This skill automates worktree creation, ensuring safe feature work and refactoring without polluting your main development environment.

How does this skill ensure worktree directories are ignored by git?

This skill enforces a safety verification step using git check-ignore. It ensures the chosen worktree directory is properly ignored, preventing you from accidentally committing worktree contents into your repository.

Can I specify a custom location for my git worktree?

Yes, you can specify a custom location. The skill resolves directory selection by checking existing directories, reading CLAUDE.md preferences, and prompting the user to determine the correct path for project-local or global worktrees.

What is the best way to automate git worktree setup for new branches?

The best way to automate git worktree setup is using this skill, which calculates the correct path, performs safety checks, creates the worktree on a new branch, and runs basic project setup automatically.

Does this skill handle project setup after creating the worktree?

Yes, this skill handles automatic worktree creation and setup. After determining the correct path and creating the worktree on the new branch, it runs a baseline project setup to prepare the isolated workspace.