using-git-worktrees

Create isolated git worktrees with directory priority and gitignore validation.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/yckkkk/reo --skill using-git-worktrees-yckkkk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/yckkkk/reo/tree/main/.agents/skills/using-git-worktrees
Command: npx skills add https://github.com/yckkkk/reo --skill using-git-worktrees-yckkkk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams safely explore changes by creating isolated git worktrees instead of switching branches, preserving a clean main workspace.

Core Features & Use Cases

  • Directory selection priorities: use existing hidden or public worktree folders, respect CLAUDE.md preferences, or ask the user.
  • Automatic safety verification: ensure worktrees are ignored by gitignore before creation, with a fallback process to fix ignores.
  • Auto-setup and baseline checks: auto-detect project tools, install dependencies when needed, and verify a clean test baseline.
  • Use Case: when starting feature work that requires isolation from current workspace or before implementing plans.

Quick Start

Set up an isolated git worktree for the current project, selecting a directory by priority and validating gitignore rules before creating the worktree.

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 without switching branches?

You create an isolated git worktree by selecting a directory based on priority rules, validating gitignore configurations, and automatically setting up the environment to keep feature work separate from the main workspace.

Why do I need a git worktree for bugfixes and experiments?

You need a git worktree to maintain a clean baseline for bugfixes and experiments, ensuring isolated branches that prevent interference with your main workspace.

What's the best way to ensure git worktrees are ignored by gitignore?

The best way is to use automatic safety verification that checks project-local gitignore rules before worktree creation, applying a fallback process to fix any missing ignore entries.

Does git worktree setup automatically install dependencies for project tools?

Yes, git worktree setup auto-detects common project toolchains, installs dependencies when needed, and verifies a clean test baseline to ensure the isolated environment functions correctly.

Can I use git worktrees across multiple environments for feature isolation?

Yes, you can use git worktrees across multiple environments to create clean baselines and separate branches, ensuring feature isolation without disrupting your main workspace.

How does directory selection work when setting up git worktrees?

Directory selection follows priority rules: using existing hidden or public worktree folders, respecting CLAUDE.md preferences, or prompting the user to ensure proper worktree placement.