Using Git Worktrees

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

193 stars 28 forksGit & Code Review

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add MavCui/Agent-Skills-Hunter --skill using-git-worktrees
Manual install
git clone --depth 1 https://github.com/MavCui/Agent-Skills-Hunter.git /tmp/Agent-Skills-Hunter
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills-Hunter/git-workflow/using-git-worktrees ~/.claude/skills/using-git-worktrees

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Using Git Worktrees

## Overview

Git worktrees create isolated workspaces sharing the same repository, allowing work on multiple branches simultaneously without switching.

**Core principle:** Systematic directory selection + safety verification = reliable isolation.

**Announce at start:** "I'm using the using-git-worktrees skill to set up an isolated workspace."

## Directory Selection Process

Follow this priority order:

### 1. Check Existing Directories

```bash
# Check in priority order
ls -d .worktrees 2>/dev/null     # Preferred (hidden)
ls -d worktrees 2>/dev/null      # Alternative
```

**If found:** Use that directory. If both exist, `.worktrees` wins.

### 2. Check CLAUDE.md

```bash
grep -i "worktree.*director" CLAUDE.md 2>/dev/null
```

**If preference specified:** Use it without asking.

### 3. Ask User

If no directory exists and no CLAUDE.md preference:

```
No worktree directory found. Where should I create worktrees?

1. .worktrees/ (project-local, hidden)
2. ~/.config/superpowers/worktrees/<project-name>/ (global location)

Which would you prefer?
```

## Safety Verification

### For Project-Local Directories (.worktrees or worktrees)

**MUST verify directory is ignored before creating worktree:**

```bash
# Check if directory is ignored (respects local, global, and system gitignore)
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null
```

**If NOT ignored:**

Per Jesse's rule "Fix broken things immediately":
Read the full skill on GitHub

Details

Skill name
using-git-worktrees
Path
git-workflow/using-git-worktrees/SKILL.md
License
MIT
Repo updated
10 March 2026
Copies
Found in 5 GitHub repos

FAQ

What does the Using Git Worktrees skill do?

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

How do I install the Using Git Worktrees skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add MavCui/Agent-Skills-Hunter --skill using-git-worktrees. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Using Git Worktrees popular?

It lives in MavCui/Agent-Skills-Hunter, which has 193 GitHub stars and 28 forks.

Related skills

Brand Guidelines

193

MavCui/Agent-Skills-Hunter

Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.

Frontend & Design28

Webapp Testing

193

MavCui/Agent-Skills-Hunter

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

Testing & QA28

Canvas Design

193

MavCui/Agent-Skills-Hunter

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

Frontend & Design28

Yeet

398

JetBrains/skills

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).

Git & Code Review35

Spring Kotlin Code Review

398

JetBrains/skills

Review Kotlin + Spring changes for behavioral regressions, transaction and proxy bugs, API and serialization mistakes, persistence risks, security issues, configuration drift, and missing tests. Use when reviewing a PR, diff, patch, or design change where generic style-focused review would miss Spring-specific correctness and operational risks.

Git & Code Review35

Github Pages Publisher

236

artwist-polyakov/polyakov-claude-skills

Publish static page artifacts from the publisher workspace to a GitHub Pages repository using a fine-grained token, with advisory image optimization and an original-image path. Use when a React/static page artifact is already prepared and needs to be copied into the Pages repo under a strict year/year-month/page-slug directory layout, then committed and pushed, with a final public artifact URL returned.

Git & Code Review59

Browse the most popular Claude skills, all git & code review skills, or write your own with the skills generator.