using-git-worktrees

Create isolated git worktrees with dependency setup and baseline tests.

5|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/russosalv/NONoise --skill using-git-worktrees-russosalv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/russosalv/NONoise/tree/main/packages/skills/vendor/superpowers/skills/using-git-worktrees
Command: npx skills add https://github.com/russosalv/NONoise --skill using-git-worktrees-russosalv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a reliable, safe way to create isolated git workspaces so developers can work on feature branches concurrently without contaminating the main repository or accidentally committing workspace artifacts.

Core Features & Use Cases

  • Deterministic directory selection: Prioritizes existing project-local directories (.worktrees, worktrees), respects CLAUDE.md preferences, and prompts the user when ambiguous.
  • Safety verification and remediation: Verifies project-local worktree directories are git-ignored, automatically adds and commits ignore entries if needed to prevent accidental tracking.
  • Automated creation and environment setup: Creates the worktree, checks out a new branch, auto-runs dependency installation/build for common platforms, and runs baseline tests to confirm a clean starting point.
  • Use Case: Start a feature branch in an isolated workspace, run the project's setup and tests, and report a ready-to-implement status without touching the primary working directory.

Quick Start

Create an isolated git worktree for branch feature/auth in the project-local .worktrees directory, run the project's setup, and execute baseline tests.

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 concurrent feature branch development?▼

To create an isolated git worktree, the skill selects a project-local directory like .worktrees, checks out a new branch, and sets up a safe separated workspace that does not contaminate the main repository.

What is the best way to prevent accidental commits of worktree directories in git?▼

The best way to prevent accidental commits is verifying the worktree directory is git-ignored, and the skill automatically adds and commits ignore entries if needed to ensure safe isolation.

How do I set up dependencies and run baseline tests in a new git worktree?▼

After creating the git worktree, the skill automates dependency installation and build processes for common platforms, then executes baseline tests to confirm a clean starting point.

Can I use git worktrees to run agent-driven tasks without altering my main workspace?▼

Yes, git worktrees provide safe separated workspaces for executing implementation plans or agent-driven tasks, ensuring the primary working directory remains completely untouched.

Does the worktree creation process respect existing project ignore configurations?▼

Yes, the worktree creation process prioritizes existing project-local directories, respects CLAUDE.md preferences, and prompts the user when directory selection is ambiguous to ensure proper configuration.