using-git-worktrees

Create isolated git worktrees with verified safety checks.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/norrbacka/threejs_codex_base --skill using-git-worktrees-norrbacka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/norrbacka/threejs_codex_base/tree/main/.codex/superpowers/skills/using-git-worktrees
Command: npx skills add https://github.com/norrbacka/threejs_codex_base --skill using-git-worktrees-norrbacka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the risk and friction of starting feature work in the wrong place by creating an isolated git worktree with verified safety checks.

Core Features & Use Cases

  • Workspace isolation: Creates a separate branch workspace without disturbing the current checkout.
  • Directory selection: Chooses the right worktree location by checking existing conventions, repository guidance, or asking for confirmation when needed.
  • Safety verification: Confirms project-local worktree paths are ignored before creation so tracked files are never polluted.
  • Baseline readiness: Detects the project type, runs setup steps, and verifies tests before implementation starts.
  • Use case: Start a new feature branch for implementation, debugging, or plan execution while keeping the main workspace clean and stable.

Quick Start

Use the using-git-worktrees skill to create a safe isolated worktree for my current feature 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 an isolated git worktree for feature development without disturbing my current checkout?

To create an isolated git worktree, the Skill selects a valid directory location, verifies the path is ignored to prevent tracked file pollution, and sets up a separate branch workspace that keeps your main checkout clean and stable.

How do I make sure my git worktree directory is safe before starting implementation?

Git worktree safety is verified by checking existing conventions, repository guidance, or asking for confirmation, ensuring project-local worktree paths are properly ignored so your tracked files are never polluted during feature development.

What is the best way to set up a git worktree and run baseline tests before branching experiments?

The best way to set up a git worktree is to detect the project type, run setup steps, and verify baseline test readiness before implementation begins, ensuring your isolated workspace is fully prepared for branching experiments.

Can I use git worktrees for debugging and plan execution while keeping my main workspace stable?

Yes, you can use git worktrees for debugging and plan execution because they provide workspace isolation, allowing you to start a new feature branch in a separate directory without affecting the stability of your main workspace.

When do I need a git worktree instead of a regular branch for my feature development?

You need a git worktree when starting implementation plans, debugging, or tasks that require workspace separation from the current checkout, ensuring your main workspace remains clean while you work in an isolated environment.

Why does my git worktree setup fail when project-local paths are not ignored?

Git worktree setup fails if project-local paths are not ignored because tracked files would be polluted, so the Skill applies safety checks to verify directory selection and ignore safety before creating the worktree.