Agent skill · software engineering · aiskillstore
create-worktree-skill
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.
Why this skill is useful
Adds a specific executable command for creating isolated git worktrees with unique configurations that the AI wouldn't reliably generate on its own.
What it needs
Requires bun, git installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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: Examples: /createworktreeprompt feature-auth - Creates worktree with auto-calculated ports /createworktreeprompt fix-bug 2 - Creates worktree with port offset 2 (ports 4020, 5193) Step 3: Share results The /createworktreeprompt 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 /createworktreeprompt 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 /createworktreeprompt hotfix-security 5 Example 3: Multiple worktrees User: "I need worktrees for branches: feature-a, feature-b, and feature-c" Your respon …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/create-worktree-skill