using-git-worktrees

Create isolated git worktrees with priority-based directory selection and safety checks.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/JasonVene/CC_MainDev --skill using-git-worktrees-jasonvene
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/JasonVene/CC_MainDev/tree/main/_archive/imports/downloads/superpowers-main/skills/using-git-worktrees
Command: npx skills add https://github.com/JasonVene/CC_MainDev --skill using-git-worktrees-jasonvene

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting feature work often requires isolation from the main workspace. This skill creates isolated git worktrees that share the same repository while preserving safety through smart directory selection and verification.

Core Features & Use Cases

  • Directory-aware isolation: automatically select or create a dedicated worktree location (.worktrees, worktrees, or a global path) to avoid cluttering the main workspace.
  • Safety-first: verifies gitignore status and enforces policy to prevent accidentally committing worktree contents.
  • Automatic project setup and baseline: detects project type and runs minimal setup and tests to ensure a clean starting point.

Quick Start

Tell me to set up an isolated git worktree for the current project.

Frequently Asked Questions about 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 uses priority-driven directory selection to automatically choose or create a dedicated location, keeping your main workspace clean while sharing the same repository for feature work.

What's the best way to prevent accidentally committing git worktree directories?

The best way to prevent accidentally committing git worktree directories is by enforcing safety checks. This skill verifies the gitignore status of the worktree location to ensure it is properly excluded from your main repository commits.

How does a git worktree isolate feature work from the main workspace?

A git worktree isolates feature work by creating a separate working directory that shares the same repository history. This allows you to develop features independently without cluttering or disrupting your main workspace.

Do I need to manually configure project setup when using git worktrees?

You do not need to manually configure project setup when using git worktrees. The skill auto-detects the project type and runs minimal setup and tests to establish a clean, validated starting baseline.

Can I specify a custom directory path for my git worktree?

Yes, you can specify a custom directory path for your git worktree. The skill applies a directory priority logic that checks existing directories, CLAUDE.md preferences, or your direct prompt to determine the correct location.

What limitations exist when using git worktrees for isolated feature branches?

A limitation of using git worktrees is the risk of accidental commits if directories are not properly ignored. The skill mitigates this by enforcing gitignore verification and running safety checks before reporting final worktree readiness.