# worktree-manager-skill

This skill handles Git worktrees for parallel development, including creation, status checks, listing, and removal.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1556
- Author: disler
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/skills/worktree-manager-skill/SKILL.md
- Updated: 2026-02-08
- HTML: https://affpapa.org/en/nevibecode/skills/worktree-manager-skill

## What it does

worktree-manager-skill manages the worktree lifecycle through dedicated slash commands. It can create a separate environment for a branch, show existing worktrees with their status, check configuration, and remove a selected worktree.

The three operations are `/create_worktree <branch-name> [port-offset]`, `/list_worktrees`, and `/remove_worktree <branch-name>`. The skill also coordinates isolated ports, databases, and configuration for parallel environments. Port and environment-file setup should stay inside the skill.

Manual Git commands are not part of this workflow, and directories should not be removed with Bash. After installing it for Claude Code, the skill file is located at `~/.claude/skills/worktree-manager-skill/SKILL.md`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/worktree-manager-skill/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/worktree-manager-skill/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/worktree-manager-skill/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/worktree-manager-skill/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install disler/claude-code-hooks-multi-agent-observability worktree-manager-skill
```

2. **Manually: put the files in place**
- File: `.github/skills/worktree-manager-skill/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/disler/claude-code-hooks-multi-agent-observability --path .claude/skills/worktree-manager-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/worktree-manager-skill/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill worktree-manager-skill -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/skills/worktree-manager-skill/SKILL.md

## When to use it
- create a worktree for a parallel branch
- list worktrees and inspect their status
- remove a worktree by branch name
- check a worktree configuration
- separate ports across development environments

## Example prompts
- Create a worktree for the `feature-auth` branch with port offset `2` using `/create_worktree feature-auth 2`.
- List the existing worktrees and show their status with `/list_worktrees`.
- Remove the worktree for `feature-auth` with `/remove_worktree feature-auth`.

## Similar
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 installs
- [git-guardrails-claude-code](https://affpapa.org/en/nevibecode/skills/git-guardrails-claude-code.md) — skill · 499069 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [scaffold-exercises](https://affpapa.org/en/nevibecode/skills/scaffold-exercises.md) — skill · 480196 installs

From the same set: [disler/claude-code-hooks-multi-agent-observability](https://affpapa.org/en/nevibecode/by/disler/claude-code-hooks-multi-agent-observability.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md