using-git-worktrees — Skills

What it does

On a branch: "Already in isolated workspace at <path> on branch <name>."

Detached HEAD: "Already in isolated workspace at <path> (detached HEAD, externally managed). Branch creation needed at finish time."

Problem: Using git worktree add when the platform already provides isolation

Fix: Step 0 detects existing isolation. Step 1a defers to native tools.

Problem: Creating a nested worktree inside an existing one

Fix: Always run Step 0 before creating anything

Problem: Worktree contents get tracked, pollute git status

Isolated git worktrees with smart directory selection and safety verification.

Source

Repository: https://github.com/obra/superpowers

using-git-worktrees 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 - ensures an isolated workspace exists via native tools or git worktree fallback On a branch: "Already in isolated workspace at <path> on branch <name>." Detached HEAD: "Already in isolated workspace at <path> (detached HEAD, externally managed). Branch creation needed at finish time."

What does using-git-worktrees require?

Configuration keys: GIT_DIR, LOCATION, BRANCH_NAME.

How do I install using-git-worktrees?

Run: npx -y skills add https://github.com/obra/superpowers --skill using-git-worktrees --agent claude-code — the source lives at github.com/obra/superpowers.

Maintain using-git-worktrees?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![using-git-worktrees on getagentictools](https://getagentictools.com/badge/skills/obra-superpowers-using-git-worktrees.svg)](https://getagentictools.com/skills/obra-superpowers-using-git-worktrees?ref=badge)

npx agentictools info skills/obra-superpowers-using-git-worktrees

The second line is the CLI lookup for this page — handy in READMEs and docs.