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.