# Create Worktree Skill

Use when the user explicitly asks for a SKILL to create a worktree.

- 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 create-worktree-skill -g -a claude-code -y`
Codex: `npx skills add disler/claude-code-hooks-multi-agent-observability --skill create-worktree-skill -g -a codex -y`
Cursor: `npx skills add disler/claude-code-hooks-multi-agent-observability --skill create-worktree-skill -g -a cursor -y`
Gemini CLI: `npx skills add disler/claude-code-hooks-multi-agent-observability --skill create-worktree-skill -g -a gemini-cli -y`

## Description

Use when the user explicitly asks for a SKILL to create a worktree. If the user does not mention "skill" or explicitly request skill invocation, do NOT trigger this. Only use when user says things like "use a skill to create a worktree" or "invoke the worktree skill". Creates isolated git worktrees with parallel-running configuration.

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

# Worktree Creator Skill

This skill enables creating fully configured git worktrees for parallel development with isolated ports, databases, and configuration.

## When to use this skill

Use this skill when:
- User asks to create a git worktree
- User wants to set up parallel development environments
- User needs to run multiple instances simultaneously
- User mentions working on multiple branches at once
- User wants isolated testing environments

## Instructions

### Step 1: Understand the request

Extract from the user's request:
- **Branch name** (required): The git branch to create the worktree from
  - If the branch name is not provided, stop and ask the user to provide a branch name
- **Port offset** (optional): Custom port offset (if not provided, auto-calculated)

### Step 2: Invoke the slash command

Use the SlashCommand tool to run:

```
/create_worktree_prompt <branch-name> [port-offset]
```

**Examples:**
- `/create_worktree_prompt feature-auth` - Creates worktree with auto-calculated ports
- `/create_worktree_prompt fix-bug 2` - Creates worktree with port offset 2 (ports 4020, 5193)

### Step 3: Share results

The `/create_worktree_prompt` command will:
- Create the git worktree in `trees/<branch-name>`
- Configure isolated ports (auto-incremented to avoid conflicts)
- Set up environment files with proper configuration
- Install dependencies for server and client
- Start both services automatically
- Provide access URLs and management instructions

Share the command output with the user, highlighting:
- Access URLs for the dashboard
- Ports being used
- How to stop/restart the worktree
- How to remove it later

## Examples

### Example 1: Simple worktree creation

**User:** "Create a worktree for the feature-dashboard branch"

**Your response:** Use SlashCommand to run `/create_worktree_prompt feature-dashboard`

### Example 2: Worktree with specific port offset

**User:** "Set up a parallel environment on branch hotfix-security with port offset 5"

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