using-git-worktrees

Create isolated Git worktrees with automatic directory selection and safety checks.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/CaptainPhantasy/floyd-v5 --skill using-git-worktrees-captainphantasy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/CaptainPhantasy/floyd-v5/tree/main/extensibility/skills/git/using-git-worktrees
Command: npx skills add https://github.com/CaptainPhantasy/floyd-v5 --skill using-git-worktrees-captainphantasy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create isolated Git worktrees for a repository to safely explore features without altering the main workspace.

Core Features & Use Cases

  • Automatic directory selection (prefers .worktrees, then worktrees), safety checks for .gitignore, and guided worktree creation.
  • Project-wide setup automation: runs project setup steps after creating the worktree for multiple languages (Node, Rust, Python, Go) to ensure a clean baseline.
  • Use cases include feature isolation, parallel experimentation, and safe experimentation before implementing plans.

Quick Start

Create a new isolated git worktree for the current project, choosing a location and branch, then run the project setup.

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?

You can create an isolated Git worktree by applying the Skill to your repository, which automatically selects a safe directory, validates .gitignore, and runs initial project setup.

What is the safest way to run experiments without altering my main Git workspace?

The safest way is using Git worktrees to isolate experiments. The Skill performs safety checks and enforces .gitignore validation to ensure your main workspace remains unaltered.

Does Git worktree creation support automatic project setup for Node and Python?

Yes, Git worktree creation supports automatic project setup for multiple languages including Node, Rust, Python, and Go, ensuring a clean baseline after workspace isolation.

Can I use Git worktrees across local or global directory locations?

Yes, you can use Git worktrees across local or global locations. The Skill applies a priority-based directory choice, preferring project-local `.worktrees` or `worktrees` folders for safe branch management.

Why does creating a project-local Git worktree require .gitignore validation?

Creating a project-local Git worktree requires .gitignore validation as a safety verification step to prevent the worktree directory from being accidentally tracked by Git in your main repository.