git-worktree

name	git-worktree
description	This skill should be used when the user wants to manage Git worktrees - creating worktrees from local or remote branches, listing active worktrees with details, deleting worktrees, or switching between worktrees. Ideal for working on multiple branches simultaneously without stashing changes.

Git Worktree Management

Overview

This skill provides comprehensive Git worktree management capabilities, enabling work on multiple branches simultaneously in isolated directories. Worktrees eliminate the need for stashing when switching contexts and are ideal for parallel development, quick bug fixes, and code reviews.

When to Use This Skill

Use this skill when the user wants to:

• Create a new worktree from a local branch, remote branch, or new branch
• List all active worktrees with detailed information
• Delete and clean up worktrees
• Get navigation commands to switch between worktrees
• Set up parallel development environments

How It Works

Configuration

Location Strategy: Sibling directory pattern

• Worktrees are created outside the main repository: ../<project>-<branch>
• Example: Main repo at ~/dev/myproject, worktree at ~/dev/myproject-feature-x
• Benefits: Clean separation, no nested repos, IDE-friendly

Naming Convention: <project>-<branch>

• Project name extracted using: basename "$(git rev-parse --show-toplevel)"
• Example: myproject-feature-auth, myapp-bugfix-login

Interface

Hybrid Mode: Accepts arguments when provided, prompts when missing

Usage patterns: