using-git-worktrees SKILL.md skillA

using-git-worktrees from wan-huiyan/agent-traffic-control is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

mdr add wan-huiyan/agent-traffic-control/using-git-worktrees@git:20260810.a58c34c

Pins git:20260810.a58c34c in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 17 of 17 checks passed

Kind

SKILL.md skill

Repository

wan-huiyan/agent-traffic-control

Path

plugins/agent-traffic-control/skills/using-git-worktrees/SKILL.md

Versions recorded

2

Latest version

git:20260810.a58c34c, committed Aug 10, 2026

First version recorded

May 13, 2026

Size

6,514 bytes

Repository stars

3

License

MIT

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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)
…

Read the whole file at its exact version.

How to install

mdr add wan-huiyan/agent-traffic-control/using-git-worktrees@sha256:08e5c8838bb614ae

[![mdr](https://markdownregistry.com/badge/art_4loknhsgxmd2s5sq.svg)](https://markdownregistry.com/a/art_4loknhsgxmd2s5sq)

Versions

The registry has recorded 2 versions of this file, between May 13, 2026 and Aug 10, 2026, about one every 89 days.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_4loknhsgxmd2s5sq
GET https://markdownregistry.com/api/v1/resolve?ref=wan-huiyan/agent-traffic-control/using-git-worktrees
GET https://markdownregistry.com/api/v1/blob/08e5c8838bb614ae1eea3475a937347b0cb7031fdb5d811b8d760bb2ec5518e7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from wan-huiyan/agent-traffic-control

Every file in wan-huiyan/agent-traffic-control

Other files named using-git-worktrees

Browse by kind, by grade A, or by owner.