using-git-worktrees SKILL.md skillA

using-git-worktrees from brunob54/superpowers-orchestrator is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add brunob54/superpowers-orchestrator/using-git-worktrees@git:20261005.2e9115a

Pins git:20261005.2e9115a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
brunob54/superpowers-orchestrator
Path
skills/using-git-worktrees/SKILL.md
Versions recorded
8
Latest version
git:20261005.2e9115a, committed Oct 5, 2026
First version recorded
Jan 29, 2026
Size
8,636 bytes
Repository stars
3
License
MIT

Use before implementation when work should be isolated from the current branch. Triggers on: "use a worktree", "isolate this work", "don't touch main", experimental or risky changes that need isolation.

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

Create an isolated branch workspace with safe defaults.

## Required Start

Announce: `I'm using the using-git-worktrees skill to set up an isolated workspace.`

## Directory Selection Priority

Check in order:

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

1. If `.worktrees/` exists — use it. If both exist, `.worktrees/` wins.
2. If `worktrees/` exists — use it.
3. Check project guidance file (e.g. `CLAUDE.md`) for a stated preference:
   ```bash
   grep -i "worktree.*director" CLAUDE.md 2>/dev/null
   ```
4. Ask user.

## Safety Check

For project-local worktree directories, verify ignore rules before creating:

```bash
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null
```

If **not** ignored:
1. Add the appropriate line to `.gitignore`.
2. **Commit the `.gitignore` change immediately** before proceeding — an uncommitted ignore entry is easy to lose and leaves the worktree contents exposed to accidental staging.

## Creation Steps

### 1. Detect project root and branch name

```bash
project=$(basename "$(git rev-parse --show-toplevel)")
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add brunob54/superpowers-orchestrator/using-git-worktrees@sha256:517a36d203361fe3

The line at the top of this page pins the label git:20261005.2e9115a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 8 versions of this file, between Jan 29, 2026 and Oct 5, 2026, about one every 35 days.

versioncommittedcommitsizeaudit
git:20261005.2e9115a latest2026-10-05 2e9115a 8,636 BA view · diff
git:20261005.8280e382026-10-05 8280e38 8,252 BA view · diff
git:20261005.2f1fe172026-10-05 2f1fe17 5,508 BA view · diff
git:20260415.0a78a702026-04-15 0a78a70 3,053 BA view · diff
git:20260328.4349b302026-03-28 4349b30 1,600 BA view · diff
git:20260308.cb7adb92026-03-08 cb7adb9 1,452 BA view · diff
git:20260305.63645302026-03-05 6364530 1,334 BA view · diff
git:20260129.bb2ff5d2026-01-29 bb2ff5d 5,635 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8636 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

brunob54/superpowers-orchestrator · 3 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_utlfjgyf5ft3gn2r
GET https://markdownregistry.com/api/v1/resolve?ref=brunob54/superpowers-orchestrator/using-git-worktrees
GET https://markdownregistry.com/api/v1/blob/517a36d203361fe3bc5e0693fd179fe749e270744137f0d713c85cc113f495dd

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 brunob54/superpowers-orchestrator

brainstorming SKILL.md skill
brunob54/superpowers-orchestrator · skills/brainstorming/SKILL.md · MUST USE when the user wants new features, behavior changes, refactoring with new capabilities, or architecture…
git:20260921.cf1d92c · audit A · 3 stars
claude-md-creator SKILL.md skill
brunob54/superpowers-orchestrator · skills/claude-md-creator/SKILL.md · Creates minimal, high-signal CLAUDE.md and AGENTS.md context files based on empirical best practices. Invoke on /init…
git:20260328.a951826 · audit A · 3 stars
context-management SKILL.md skill
brunob54/superpowers-orchestrator · skills/context-management/SKILL.md · Use in long or noisy sessions to persist durable state across session boundaries via state.md. Also generates…
git:20261008.473e04a · audit A · 3 stars
dashboard SKILL.md skill
brunob54/superpowers-orchestrator · skills/dashboard/SKILL.md · Shows the status of this repository on a claude.ai Artifact page — unfinished orchestration runs, branches, work logs…
git:20261025.5ed9039 · audit A · 3 stars
deliberation SKILL.md skill
brunob54/superpowers-orchestrator · skills/deliberation/SKILL.md · Use BEFORE brainstorming when facing a complex architectural, technology, or design decision where the options are not…
git:20260415.0a78a70 · audit A · 3 stars
dependency-management SKILL.md skill
brunob54/superpowers-orchestrator · skills/dependency-management/SKILL.md · MUST USE when updating, migrating, or auditing project dependencies: upgrading packages, fixing security…
git:20260508.ae16bf3 · audit A · 3 stars
dispatching-parallel-agents SKILL.md skill
brunob54/superpowers-orchestrator · skills/dispatching-parallel-agents/SKILL.md · Use when 2+ tasks are independent and can run concurrently without file or state conflicts or sequential dependencies…
git:20260815.dcd9fd0 · audit A · 3 stars
error-recovery SKILL.md skill
brunob54/superpowers-orchestrator · skills/error-recovery/SKILL.md · Maintains a project-specific known-issues.md mapping recurring errors to their solutions. Consulted automatically by…
git:20260313.623081f · audit A · 3 stars
executing-plans SKILL.md skill
brunob54/superpowers-orchestrator · skills/executing-plans/SKILL.md · MUST USE when a plan.md exists and implementation needs to begin. Executes in controlled batches with verification…
git:20260817.e70e480 · audit A · 3 stars
finishing-a-development-branch SKILL.md skill
brunob54/superpowers-orchestrator · skills/finishing-a-development-branch/SKILL.md · MUST USE when implementation is verified and you need to choose the branch outcome: merge, PR, keep, or discard…
git:20261005.8280e38 · audit A · 3 stars
frontend-design SKILL.md skill
brunob54/superpowers-orchestrator · skills/frontend-design/SKILL.md · MUST USE for any frontend, UI, or web interface implementation. Enforces production-grade visual quality…
git:20260508.ae16bf3 · audit A · 3 stars
handoff SKILL.md skill
brunob54/superpowers-orchestrator · skills/handoff/SKILL.md · Write a continuation prompt for a fresh session into tmp/docs/<date>-handoff-<slug>.md, save state, and print the…
git:20260915.87c8587 · audit A · 3 stars

Every file in brunob54/superpowers-orchestrator

Other files named using-git-worktrees

using-git-worktrees SKILL.md skill
obra/superpowers · skills/using-git-worktrees/SKILL.md · Use when starting feature work that needs isolation from current workspace or before executing implementation plans -…
git:20260724.bc86802 · audit A · 314,583 stars
using-git-worktrees SKILL.md skill
jnmetacode/superpowers-zh · skills/using-git-worktrees/SKILL.md · 当需要开始与当前工作区隔离的功能开发,或在执行实现计划之前使用——通过原生工具或 git worktree 回退机制确保隔离工作区存在
v1.0.0 · audit A · 8,494 stars
using-git-worktrees SKILL.md skill
a5c-ai/babysitter · library/methodologies/superpowers/skills/using-git-worktrees/SKILL.md · Use when starting feature work that needs isolation from current workspace or before executing implementation plans.
git:20260601.da7723a · audit A · 1,896 stars
using-git-worktrees SKILL.md skill
ganyuanran/aegis · skills/using-git-worktrees/SKILL.md · Use when a coding task needs a concurrent checkout, unrelated dirty state blocks safe branch switching, or the user or…
git:20260827.661bec4 · audit A · 1,417 stars
using-git-worktrees SKILL.md skill
coco-research/coco · skills/using-git-worktrees/SKILL.md · Use when starting feature work that needs isolation from current workspace or before executing implementation plans -…
git:20260802.1479e32 · audit A · 629 stars
using-git-worktrees SKILL.md skill
xu123-bob/baize · agent/skills/superpowers/5.1.0/skills/using-git-worktrees/SKILL.md · Use when starting feature work that needs isolation from current workspace or before executing implementation plans -…
git:20260912.5e131e8 · audit A · 617 stars
using-git-worktrees SKILL.md skill
jamditis/claude-skills-journalism · superjawn/skills/using-git-worktrees/SKILL.md · Creates isolated git worktrees with smart directory selection and safety checks. Use when starting isolated feature…
git:20261024.21f0bb2 · audit A · 450 stars
using-git-worktrees SKILL.md skill
ibrahim-3d/orchestrator-supaconductor · skills/using-git-worktrees/SKILL.md · Use when starting feature work that needs isolation from current workspace or before executing implementation plans -…
git:20260312.c37221c · audit A · 381 stars

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