Development · Source review 2026-10-27

Superpowers Using Git Worktrees

A workspace-isolation workflow that checks existing worktree state before creating another checkout. It favors host-native worktree controls where available.

Publisher: Jesse Vincent / Prime Radiant · Editorial profile by AI Tools Ratings · Review method

What task is this skill designed for?

Prepare an isolated checkout for a synthetic feature while preserving an uncommitted change in the original repository.

What input and output should you expect?

Input: A repository, desired starting revision, branch policy and the location of existing uncommitted changes. Keep a separate record of the original file content.

Output: An identified working directory and branch state, plus setup and baseline-check results. Existing work should remain intact in its original checkout.

What does it need to run?

Git and a coding agent with filesystem and command access. Native worktree tools depend on the host. Project setup may require language runtimes and dependency downloads.

Publisher README documents Claude Code, Codex and Cursor installation paths, among other harnesses. Tool availability and behavior depend on the host; this is publisher-declared support, not a cross-platform test result.

How should you approach installation?

  1. Review the pinned folder and its referenced files before enabling the workflow. The folder belongs to the broader Superpowers plugin, not an independently verified standalone installer.
  2. Follow the publisher README for your chosen coding-agent platform. The publisher documents several harnesses; use the instructions for your installed version and review plugin hooks and permissions.
  3. Try the suggested task in a disposable repository with synthetic inputs. Check the acceptance list before applying the workflow to shared work.

Installation guide: discovery, dependencies and runtime checks

What files, accounts or data can it access?

Can create directories and Git branches, inspect ignore rules, and run setup or test commands. Dependency setup can use the network and execute package lifecycle scripts; review it before enabling the workflow.

What does the skill cost?

No separate skill purchase is specified in the MIT-licensed source. Coding-agent subscriptions, model tokens, test compute and any external services have their own charges. Review or repeated execution can increase model usage.

What are its limits and alternatives?

A worktree separates files and branch state but is not a security sandbox. External services, credentials and some resources may still be shared. The source distinguishes linked worktrees from submodules; incorrect classification can create redundant or misplaced checkouts.

Use the current checkout for a small isolated edit when no competing work exists. Use a separate container when the requirement is execution security rather than branch isolation.

What could you ask in a small trial?

Try this with a small sample:

Prepare an isolated workspace from the agreed revision in this disposable repository. Detect whether isolation already exists, preserve the original dirty file and report the actual branch and baseline checks.

How would you verify the result?

  1. The original uncommitted file remains unchanged.
  2. The reported path and branch match Git state, including detached HEAD when applicable.
  3. The workflow does not create a second worktree when already in a suitable linked checkout.

Use a baseline and record acceptance evidence before treating a successful task as a reliable workflow.

Which source and license were checked?

Read the reviewed SKILL.md at its pinned commit · Complete reviewed folder

Repository and current publisher guidance

Checked:

MIT — repository LICENSE at the reviewed commit. Dependencies and external services retain their own terms. License evidence

Version details and review scope

Source: obra/superpowers/skills/using-git-worktrees
Reviewed commit: 2ce8aa15d05bd57213e6f746f953aafb7ded7a8b

SKILL.md SHA-256: 8cfb86f121269e8f7f12361e6795c4f6738828340e28964c9229d365666c9edd

Source-document review. This profile covers the source workflow, stated dependencies and license evidence. See our editorial methodology for how we distinguish source reviews and hands-on evaluations.

Report an error, license concern or request a new review.

Compare related development workflows

Development · Codex source

OpenAI GitHub CI Fix Skill

Investigates failing GitHub Actions checks using GitHub CLI logs, summarizes the failure and proposes a repair before changes. It explicitly treats external CI providers as outside its repair scope.

Source checked 2026-10-23

Development · Codex source

OpenAI Playwright CLI Skill

Guides an agent through browser interactions using Playwright CLI and a bundled wrapper. It emphasizes inspecting a fresh page snapshot before acting, which helps keep clicks tied to the interface currently on screen.

Source checked 2026-10-23

Development · Codex source

OpenAI GitHub Review Comments Skill

Collects review threads from the pull request for the current branch, summarizes what each comment requires and lets the user choose which changes to address. It separates a review request from unrestricted code modification.

Source checked 2026-10-23

Get listed

Put your AI tool in front of people who are already comparing options.

Submit a listing for editorial review. Include a live website, current pricing and a clear use case. We may request more information before publication.

Submit a tool