obra/superpowers@using-git-worktrees

Create isolated Git worktrees, install dependencies, and run baseline tests.

2.0k|267|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/openakita/openakita --skill obra-superpowers-using-git-worktrees-openakita
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obra/superpowers@using-git-worktrees
Source: https://github.com/openakita/openakita/tree/main/skills/superpowers-git-worktrees
Command: npx skills add https://github.com/openakita/openakita --skill obra-superpowers-using-git-worktrees-openakita

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the creation of isolated Git worktrees for feature development, ensuring a clean and safe development environment by verifying directory safety and running baseline tests.

Core Features & Use Cases

  • Isolated Workspaces: Create separate directories for different branches without duplicating the entire repository.
  • Smart Directory Selection: Prioritizes preferred locations (.worktrees/, worktrees/) or prompts the user for global locations.
  • Safety Verification: Ensures project-local directories are ignored by Git before creation to prevent accidental commits.
  • Automated Setup: Detects and runs project-specific setup commands (npm, cargo, pip, poetry, go).
  • Baseline Testing: Runs project tests to confirm a clean starting state.
  • Use Case: Before starting a new feature like "user authentication," use this skill to create a dedicated, isolated worktree, install dependencies, and run initial tests, ensuring a clean slate for development.

Quick Start

Use the using-git-worktrees skill to set up an isolated workspace for the 'feature/user-auth' branch.

Frequently Asked Questions about obra/superpowers@using-git-worktrees

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an isolated Git worktree for feature development?▼

Creating an isolated Git worktree involves selecting a directory, verifying it is ignored by Git, installing dependencies, and running tests to ensure a clean baseline for feature development.

Why do I need to verify .gitignore before setting up a local Git worktree?▼

Verifying .gitignore before setting up a Git worktree prevents accidental commits of the worktree directory itself, ensuring project-local directories like .worktrees/ remain safely isolated from the main repository history.

Does Git worktree automated setup work with npm, cargo, and poetry projects?▼

Yes, Git worktree automated setup detects and runs project-specific setup commands for npm, cargo, pip, poetry, and go, ensuring dependencies are installed correctly within the isolated workspace.

What is the best way to manage isolated workspaces for different Git branches?▼

Using Git worktrees is the best way to manage isolated workspaces for different branches, creating separate directories without duplicating the entire repository to keep feature development isolated.

Can I run project tests immediately after creating a Git worktree?▼

Yes, you can run project tests immediately after creating a Git worktree because this skill runs baseline tests automatically to confirm a clean starting state before you begin implementing new features.