using-git-worktrees

Create isolated Git worktrees with automated setup and baseline testing.

1|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/PREDICTif/supervisor-worker-ai-framework --skill using-git-worktrees-predictif
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/PREDICTif/supervisor-worker-ai-framework/tree/main/superpowers/skills/using-git-worktrees
Command: npx skills add https://github.com/PREDICTif/supervisor-worker-ai-framework --skill using-git-worktrees-predictif

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of creating isolated development environments using Git worktrees, ensuring a clean separation between different branches and features without the overhead of managing separate repositories.

Core Features & Use Cases

  • Safe Worktree Creation: Automatically selects an appropriate directory for new worktrees, prioritizing project-local hidden directories (.worktrees/) and falling back to global configurations.
  • Safety Verification: Crucially verifies that project-local worktree directories are ignored by Git before creation, preventing accidental commits of worktree contents.
  • Automated Setup: Detects and runs project-specific setup commands (e.g., npm install, cargo build, pip install) within the new worktree.
  • Baseline Testing: Executes project tests to ensure a clean and stable starting point for new feature development.
  • Use Case: When starting a new feature like "user authentication," this Skill will create a dedicated, isolated Git worktree, install dependencies, run tests, and report the worktree's location, allowing you to code without affecting your main branch.

Quick Start

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

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 isolated Git worktrees for new feature branches?

Git worktrees allow isolated feature development by creating a separate directory for a branch, automatically installing project dependencies, and running baseline tests to ensure a clean starting point without affecting your main workspace.

Does the worktree creation process check if the directory is ignored by Git?

Yes, verifying that project-local worktree directories are properly ignored by Git is crucial. The process checks ignore rules before creation to prevent accidental commits of worktree contents into the main repository.

Can I use this worktree setup workflow for Node.js, Rust, Python, and Go projects?

Yes, the worktree setup workflow supports Node.js, Rust, Python, and Go projects. It automatically detects and executes project-specific setup commands like npm install, cargo build, or pip install within the newly created worktree.

Why should I use Git worktrees instead of cloning the repository again?

Git worktrees provide clean branch isolation without the overhead of managing separate cloned repositories. They allow simultaneous feature development by sharing a single repository, saving disk space and ensuring branch synchronization.

Where are the new Git worktrees stored on my local machine?

New Git worktrees are stored in an automatically selected directory, prioritizing project-local hidden directories like `.worktrees/`, and falling back to global configurations if local setups are not available or ignored properly.