using-git-worktrees

Create isolated feature workspaces using native tools or git worktrees.

1|Updated May 28, 2026
One-click install
npx skills add https://github.com/amoutiers/maxi-superpowers --skill using-git-worktrees-amoutiers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/amoutiers/maxi-superpowers/tree/main/skills/using-git-worktrees
Command: npx skills add https://github.com/amoutiers/maxi-superpowers --skill using-git-worktrees-amoutiers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensure work happens in an isolated workspace. Prefer your platform's native worktree tools. Fall back to manual git worktrees only when no native tool is available.

Core Features & Use Cases

  • Detect existing isolation and skip creating a new workspace when already isolated.
  • Prefer native tools for workspace creation; fall back to git worktrees if needed.
  • Respect user consent and existing preferences before creating isolation.
  • Verify a clean baseline by setting up the workspace and reporting status.

Quick Start

Ask me to set up an isolated workspace for your feature work using native tools first, or fall back to a git worktree if native tooling is unavailable.

Frequently Asked Questions about using-git-worktrees

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

FAQPage Schema
How do I isolate feature development work in a separate git workspace?

To isolate feature development, you can create a clean directory using native workspace tooling, or fall back to a git worktree if native tools are unavailable. This ensures your feature work happens in an isolated workspace.

What is a git worktree and when should I use it for feature isolation?

A git worktree is a native mechanism that creates an isolated directory for your feature work. You should use it as a fallback when your platform's native workspace isolation tools are not available.

How do I check if my git worktree is already isolated before creating a new one?

You need to run an isolation detection process before creating a new workspace. The workflow automatically skips creating a new isolated directory if it detects that your environment is already properly isolated.

Do I need native workspace tooling to set up an isolated git worktree?

No, you do not need native workspace tooling. The setup prefers native tools when available, but automatically falls back to creating a manual git worktree with project-local ignore checks and basic setup validation.

What is the best way to manage consent and guardrails when creating a git worktree?

The best way to manage consent and guardrails is to use a workflow that respects existing user preferences before creating isolation. It validates the clean baseline setup and reports the workspace status to ensure safe feature development.

Why does my git worktree fallback setup fail validation?

Git worktree setup validation fails when the baseline is not clean or project-local ignore checks are not properly configured. The workflow requires basic setup validation to report a successful isolated workspace status.