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"

Your response: Use SlashCommand to run /create_worktree_prompt hotfix-security 5

Example 3: Multiple worktrees

User: "I need worktrees for branches: feature-a, feature-b, and feature-c"

Your response:

• Use SlashCommand to run /create_worktree_prompt feature-a

• Use SlashCommand to run /create_worktree_prompt feature-b

• Use SlashCommand to run /create_worktree_prompt feature-c

Each will automatically get unique ports (4010/5183, 4020/5193, 4030/5203).

Related capabilities

• The created worktree will run automatically with isolated ports, database, and configuration

• Each worktree is completely independent and can run simultaneously with others

Troubleshooting

If the command fails, common issues:

• Branch name already exists as a worktree

• Ports are in use (command kills them automatically)

• Missing dependencies (ensure bun is installed)

• Git worktree errors (handle uncommitted changes first)

The slash command provides detailed error messages and suggestions.