Create worktree skill

Skill bg-szy/TOP-SKILLS/skills/marketplace/create-worktree-skill

全球最大的 Claude Code 技能聚合库 · 收录 3900+ 来自 12+ 来源的技能，提供在线搜索与趋势分析看板 / The world's largest Claude Code skill aggregation hub — 3900+ skills from 12+ sources with online search and trend dashboard

Install

npx -y skills add bg-szy/TOP-SKILLS --skill create-worktree-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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

3.4 KB, 669 tokens by cl100k_base, as published. Nobody here has run it

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.