using-git-worktrees

Create isolated Git worktrees for feature development with safety checks.

3|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/falconnt/windsurf-skills --skill using-git-worktrees-falconnt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-git-worktrees
Source: https://github.com/falconnt/windsurf-skills/tree/main/using-git-worktrees
Command: npx skills add https://github.com/falconnt/windsurf-skills --skill using-git-worktrees-falconnt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams set up isolated Git worktrees to enable feature work without polluting the main workspace.

Core Features & Use Cases

  • Isolated Workspaces: Create per-feature worktrees detached from the current branch.
  • Smart Directory Selection: Prefers hidden .worktrees over public folders with fallback options.
  • Safety & Compliance: Verifies ignore rules and project configuration before creating a worktree.
  • Use Case: When starting a new feature branch while preserving a clean mainline.

Quick Start

Use the using-git-worktrees skill to set up an isolated workspace.

Frequently Asked Questions about using-git-worktrees

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I isolate feature work with git worktrees without disturbing my main workspace?

To isolate feature work with git worktrees, you can create per-feature worktrees detached from your current branch. This sets up isolated workspaces that prevent pollution of your main directory while preserving a clean mainline.

What's the best way to manage multi-branch experiments in git?

The best way to manage multi-branch experiments is using git worktrees to create isolated workspaces for parallel feature work. This allows you to run experiments in separate directories without disturbing the main workspace.

How does directory discovery work when creating git worktrees?

Directory discovery for git worktrees prefers hidden .worktrees folders over public directories, with fallback options available. It automatically identifies suitable locations based on user or config-driven choices before creating the worktree.

How can I verify ignore rules and project configuration before creating a git worktree?

To verify ignore rules and project configuration, the system performs safety and compliance checks before creating a git worktree. This ensures ignore rules are applied correctly and project setup commands are validated.

Can I use git worktrees for parallel feature work across different branches?

Yes, you can use git worktrees for parallel feature work across different branches. The system applies isolated worktrees during multi-branch experiments and parallel feature work, allowing simultaneous development without workspace conflicts.