using-git-worktrees SKILL.md skillA

using-git-worktrees from jjuraszek/pi-gauntlet is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jjuraszek/pi-gauntlet/using-git-worktrees@git:20261020.c79e361

Pins git:20261020.c79e361 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jjuraszek/pi-gauntlet
Path
skills/using-git-worktrees/SKILL.md
Versions recorded
7
Latest version
git:20261020.c79e361, committed Oct 20, 2026
First version recorded
Jul 2, 2026
Size
16,128 bytes
Repository stars
19
License
a license file GitHub does not identify

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

> **Related skills:** Set up **before** `/skill:brainstorming` — the spec is the worktree's first commit, not a separate one on `main`. Execute with `/skill:subagent-driven-development`. Clean up with `/skill:finishing-a-development-branch`.

# Using Git Worktrees

## Overview

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

**Core principle:** Detect existing isolation first → prefer the project's native tool → default to `<repo>/.worktrees/<branch>`, creating it if missing.

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

## Step 0 — Detect Existing Isolation (REQUIRED)

Before doing anything else, check whether you are **already** inside an isolated worktree. Creating a worktree inside another worktree, or inside a submodule, produces silent corruption.

```bash
read -r GIT_DIR GIT_COMMON <<<"$(git rev-parse --path-format=absolute --git-dir --git-common-dir | tr '\n' ' ')"
ROOT=$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")
CURRENT_BRANCH=$(git branch --show-current)
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jjuraszek/pi-gauntlet/using-git-worktrees@sha256:7d6a8877559da6ff

The line at the top of this page pins the label git:20261020.c79e361, 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_tzcwdrvpi4xbvoew.svg)](https://markdownregistry.com/a/art_tzcwdrvpi4xbvoew)

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

Versions

The registry has recorded 7 versions of this file, between Jul 2, 2026 and Oct 20, 2026, about one every 18 days.

versioncommittedcommitsizeaudit
git:20261020.c79e361 latest2026-10-20 c79e361 16,128 BA view · diff
git:20261017.836bbce2026-10-17 836bbce 15,954 BA view · diff
git:20260923.88370ec2026-09-23 88370ec 11,843 BA view · diff
git:20260917.5fd185d2026-09-17 5fd185d 11,688 BA view · diff
git:20260827.a970d9b2026-08-27 a970d9b 11,400 BA view · diff
git:20260818.1338f942026-08-18 1338f94 9,195 BA view · diff
git:20260702.57334df2026-07-02 57334df 8,989 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 (16128 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

jjuraszek/pi-gauntlet · 19 stars · license a license file GitHub does not identify · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tzcwdrvpi4xbvoew
GET https://markdownregistry.com/api/v1/resolve?ref=jjuraszek/pi-gauntlet/using-git-worktrees
GET https://markdownregistry.com/api/v1/blob/7d6a8877559da6ff54db7280ca8082831461048807880d370c1de60ecab9ebdf

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 jjuraszek/pi-gauntlet

release SKILL.md skill
jjuraszek/pi-gauntlet · .agents/skills/release/SKILL.md · Use when asked to release, publish, bump the version, or cut a tag for jjuraszek/pi-gauntlet.
git:20261020.c79e361 · audit A · 19 stars
AGENTS.md AGENTS.md file
jjuraszek/pi-gauntlet · AGENTS.md
git:20261020.c79e361 · audit A · 19 stars
AGENTS.md@eval/forge-skill/samples/history-section-cleanup/fixture AGENTS.md file
jjuraszek/pi-gauntlet · eval/forge-skill/samples/history-section-cleanup/fixture/AGENTS.md
git:20261018.dc0a360 · audit B · 19 stars
release-notes SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/minimal-diff-one-line/fixture/SKILL.md · Use when asked to draft release notes from a merged changelog section.
git:20261007.500497b · audit A · 19 stars
audit-runbook SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/oversized-skill-extraction/fixture/SKILL.md · Use when asked to audit a service deployment against the twelve runbook sections.
git:20261007.500497b · audit A · 19 stars
answer-question SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/prohibition-to-recipe/fixture/SKILL.md · Use when the user asks a factual question about the codebase and wants a direct answer.
git:20261007.500497b · audit A · 19 stars
pr-checklist SKILL.md skill
jjuraszek/pi-gauntlet · eval/forge-skill/samples/reference-file-edit/fixture/SKILL.md · Use before opening a pull request to run the project's pre-merge checks.
git:20261007.500497b · audit A · 19 stars
AGENTS.md@eval/forge-skill/samples/untouched-history-stays/fixture AGENTS.md file
jjuraszek/pi-gauntlet · eval/forge-skill/samples/untouched-history-stays/fixture/AGENTS.md
git:20261018.dc0a360 · audit B · 19 stars
brainstorming SKILL.md skill
jjuraszek/pi-gauntlet · skills/brainstorming/SKILL.md · Use only when the user explicitly requests brainstorming or selects a handoff into it.
git:20261020.c79e361 · audit A · 19 stars
chase-bug SKILL.md skill
jjuraszek/pi-gauntlet · skills/chase-bug/SKILL.md · Use when a human hands you a bug report to triage - a Slack paste, tracker ticket, GitHub issue, or described symptom -…
git:20261020.c79e361 · audit A · 19 stars
check-delivery SKILL.md skill
jjuraszek/pi-gauntlet · skills/check-delivery/SKILL.md · Use only when explicitly asked to prove delivery of a named merged ticket ("check delivery of ABC-123", a loop task…
git:20261020.c79e361 · audit A · 19 stars
dispatching-parallel-agents SKILL.md skill
jjuraszek/pi-gauntlet · skills/dispatching-parallel-agents/SKILL.md · Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies, when…
git:20261020.c79e361 · audit A · 19 stars

Every file in jjuraszek/pi-gauntlet

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 · 302,424 stars
using-git-worktrees SKILL.md skill
jnmetacode/superpowers-zh · skills/using-git-worktrees/SKILL.md · 当需要开始与当前工作区隔离的功能开发,或在执行实现计划之前使用——通过原生工具或 git worktree 回退机制确保隔离工作区存在
v1.0.0 · audit A · 8,348 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,862 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,371 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 · 827 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 · 581 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:20260818.3e0e3a8 · audit A · 427 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 · 380 stars

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