superpowers-using-git-worktrees

Create isolated git worktrees with safety checks and automated project setup.

2|1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/aldoborrero/agent-kit --skill superpowers-using-git-worktrees
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-using-git-worktrees
Source: https://github.com/aldoborrero/agent-kit/tree/main/skills/superpowers/using-git-worktrees
Command: npx skills add https://github.com/aldoborrero/agent-kit --skill superpowers-using-git-worktrees

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Isolate feature work from the current workspace by creating and managing Git worktrees with safety checks and automated setup.

Core Features & Use Cases

  • Directory selection priority: prefers project-local .worktrees, then worktrees, then CLAUDE.md preferences, and finally prompts the user for a location.
  • Safety verification: ensures the chosen directory is ignored by git to prevent accidental commits from worktrees; provides remediation steps when needed.
  • End-to-end workflow: detects project name, creates the worktree on a new branch, runs project setup (language-specific) and validates a clean baseline with tests.
  • Integration-ready: reports the final worktree location and readiness for feature implementation.

Quick Start

Announce that you are using the using-git-worktrees skill to set up an isolated workspace and proceed with creating the worktree.

Frequently Asked Questions about 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?

To create an isolated git worktree, the skill automates directory selection, validates that the location is git-ignored to prevent accidental commits, and sets up the branch with project-specific tooling for safe feature work.

What is the safest way to manage git worktrees without affecting my current workspace?

Managing git worktrees safely requires verifying the target directory is ignored by git. This skill enforces safety checks and provides remediation steps to ensure worktree changes never accidentally pollute your main repository.

How do I set up a new git branch with automated project tool installation?

Setting up a new git branch via worktrees triggers automated project setup. This skill detects your project name, creates the worktree, and runs language-specific tool installation to validate a clean baseline with tests.

Does git worktree isolation work with my existing CLAUDE.md preferences?

Yes, git worktree isolation respects your CLAUDE.md preferences. Directory selection prioritizes project-local .worktrees, then a generic worktrees folder, then CLAUDE.md configurations, and finally prompts you for a custom location.

Why are my git worktree files showing up in the main repository commits?

Git worktree files appear in main repository commits if the target directory is not properly ignored. This skill performs safety verification to ensure the worktree path is git-ignored and offers remediation steps to fix the configuration.