using-git-worktrees

Set up isolated git worktrees with submodule and baseline test validation.

2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/LisztVan/subcli-cpp --skill using-git-worktrees-lisztvan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/LisztVan/subcli-cpp/tree/main/.pi/skills/superpowers/skills/using-git-worktrees
Command: npx skills add https://github.com/LisztVan/subcli-cpp --skill using-git-worktrees-lisztvan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill creates an isolated workspace for feature work so changes do not pollute the current checkout or branch.

Core Features & Use Cases

  • Detects whether you are already in a linked worktree before doing anything.
  • Prefers native worktree tooling, with a git fallback when necessary.
  • Handles submodules, ignored directories, baseline setup, and test verification.
  • Use it when starting implementation work that should be separated from the current branch.

Quick Start

Ask me to set up an isolated worktree for this repository before I start making changes.

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 work?

Git worktrees provide separate working directories for different branches within the same repository, allowing you to isolate feature work from your current checkout without stashing or committing ongoing changes.

Does git worktree work with repositories that use submodules?

Yes, git worktree setup includes submodule guards to properly handle repositories with submodules, ensuring isolated workspaces are configured safely without breaking submodule state during feature branch work.

How do I set up a git worktree without polluting my current branch?

Setting up an isolated git worktree requires directory selection, ignored directory verification, and baseline test validation, ensuring your current checkout remains completely untouched while you work on separate feature branches.

What happens if native git worktree tooling is unavailable?

Git worktree setup applies a safe fallback mechanism with isolation detection when native tooling is unavailable, ensuring the workspace remains separated from your current checkout.

Can I use an isolated workspace for running implementation plans and tests?

Yes, isolated git worktrees are designed for feature branches, implementation plans, and any task needing a separate workspace, complete with baseline setup and test verification to validate the environment before you begin.