using-git-worktrees

Create isolated Git worktrees with safety checks and baseline verification.

6|2|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/EricOo0/stock-trading-platform --skill using-git-worktrees-ericoo0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/EricOo0/stock-trading-platform/tree/main/.codex/superpowers/skills/using-git-worktrees
Command: npx skills add https://github.com/EricOo0/stock-trading-platform --skill using-git-worktrees-ericoo0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

Core Features & Use Cases

  • Creates isolated git worktrees sharing the same repository, enabling concurrent feature work without changing the main workspace.
  • Smart directory selection and safety verification: prefers existing worktree directories, checks CLAUDE.md for preferences, and asks the user when needed; ensures ignored directories to prevent accidental commits.
  • Safe creation workflow: automatically detects project name, derives the worktree path (local or global), creates the worktree, and runs project setup commands appropriate to the project (package managers, compilers) and verifies a clean baseline.

Quick Start

Use this skill to set up an isolated workspace for a new feature branch, ensuring the worktree is ignored and tests can run from a clean baseline.

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 workspace for concurrent feature branches?

Git worktrees provide isolated workspaces sharing the same repository, enabling concurrent feature work without changing the main workspace. They are needed when preparing new features across branches while keeping your primary directory clean and unaltered.

How do I ensure my git worktree directory is ignored to prevent accidental commits?

Yes, this skill handles worktree setup by automatically detecting the project name, deriving the worktree path, creating the worktree, and running project-specific setup commands like package manager installations to verify a clean baseline.

Can I specify a global directory location for my isolated git worktrees?

This skill automates worktree creation with smart directory selection, ignore verification via git check-ignore, automatic environment setup, and baseline test verification, reducing manual configuration errors compared to standard git worktree commands.

How do I run baseline tests after setting up an isolated git worktree?

Before using this skill, ensure your project has a valid git repository and recognizable setup commands. The skill detects package managers and compilers to establish a verified clean baseline within the newly created worktree.