# Worktree Manager Skill

Comprehensive git worktree management.

- Repository: https://github.com/disler/claude-code-hooks-multi-agent-observability (1564 stars)
- Category: Git and review
- License: see repository
- Last updated: 2026-02-08
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -g -a claude-code -y`
Codex: `npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -g -a codex -y`
Cursor: `npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -g -a cursor -y`
Gemini CLI: `npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -g -a gemini-cli -y`

## Description

Comprehensive git worktree management. Use when the user wants to create, remove, list, or manage worktrees. Handles all worktree operations including creation, deletion, and status checking.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Worktree Manager Skill

Complete worktree lifecycle management for parallel development environments with isolated ports, databases, and configuration.

## When to use this skill

Use this skill when the user wants to:
- **Create** a new worktree for parallel development
- **Remove** an existing worktree
- **List** all worktrees and their status
- **Check** worktree configuration or status
- **Manage** multiple parallel development environments

**Do NOT use this skill when:**
- User asks for a specific subagent or skill delegation
- User wants to manually use git commands directly
- The task is unrelated to worktree management

## Operations Overview

This skill manages three core worktree operations:

| Operation | Command | When to Use |
|-----------|---------|-------------|
| **Create** | `/create_worktree` | User wants a new parallel environment |
| **List** | `/list_worktrees` | User wants to see existing worktrees |
| **Remove** | `/remove_worktree` | User wants to delete a worktree |

## Decision Tree: Which Command to Use

### 1. User wants to CREATE a worktree
**Keywords:** create, new, setup, make, build, start, initialize
**Action:** Use `/create_worktree <branch-name> [port-offset]`

### 2. User wants to LIST worktrees
**Keywords:** list, show, display, what, which, status, check, view
**Action:** Use `/list_worktrees`

### 3. User wants to REMOVE a worktree
**Keywords:** remove, delete, cleanup, destroy, stop, kill, terminate
**Action:** Use `/remove_worktree <branch-name>`

## Quick Start

For step-by-step operation instructions, see [OPERATIONS.md](OPERATIONS.md).

For detailed examples and usage patterns, see [EXAMPLES.md](EXAMPLES.md).

For troubleshooting and common issues, see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).

For technical details and quick reference, see [REFERENCE.md](REFERENCE.md).

## Important Notes

The rest: https://github.com/disler/claude-code-hooks-multi-agent-observability/blob/HEAD/.claude/skills/worktree-manager-skill/SKILL.md