worktree-create
/worktree-create
Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per worktree. Use when starting isolated parallel work, running several PIV loops at once, or when the user says "set up worktrees", "create a worktree", "spin up parallel branches", or invokes /worktree-create.
- Author
- coleam00 ↗
- Repository
- skills ↗
- Licence
- MIT
- Last repository change
- 07.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 07.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per worktree. Use when starting isolated parallel work, running several PIV loops at once, or when the user says "set up worktrees", "create a worktree", "spin up parallel branches", or invokes /worktree-create.
Triggers from the description
Arguments
/worktree-create [branch ...] (one or more branch names; blank = ask)
Original author description
Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per worktree. Use when starting isolated parallel work, running several PIV loops at once, or when the user says "set up worktrees", "create a worktree", "spin up parallel branches", or invokes /worktree-create.
How it works
- Input
- Detect the project setup ONCE, before fanning out
- Fan out one setup subagent per branch (parallel)
- Aggregate and report
- Resources
SKILL.md preview
--- name: worktree-create description: Create one or more git worktrees for parallel development, each on its own branch with gitignored config copied in, dependencies installed, and a health check, by fanning out a setup subagent per worktree. Use when starting isolated parallel work, running several PIV loops at once, or when the user says "set up worktrees", "create a worktree", "spin up parallel branches", or invokes /worktree-create. argument-hint: "[branch ...] (one or more branch names; blank = ask)" --- # Worktree Create Stand up **any number** of isolated git worktrees from a list of branches — each created off the right base, given its gitignored config, its dependencies, and a health check — by fanning out one setup subagent per worktree so they run in parallel. The per-worktree work is app-agnostic and **detected from the repo**, never hardcoded. ## Input `$ARGUMENTS` is the list of branches to create. - **None given** → ask which branches to create (or offer to derive them from the tickets in play). Don't guess. - **One** → set up a single worktree inline (a fan-out of one is unnecessary). - **Two or more** → fan out one subagent per branch, in parallel. ## Detect the project setup ONCE, before fanning out Read `references/worktree-setup.md` — it is the general checklist of everything a fresh worktree needs plus how to detect each piece. Determine from **this** repo (not from assumptions), one time: - the **install command(s)** (monorepo → one per package), - the **gitignored env/config files to copy** (or the repo's `.worktreeinclude`), - the **verification/health-check command** (a health endpoint if the app exposes one, else a build/test smoke — prefer whatever CI runs), - a **base port**, only if the health check starts a service. Pick a worktree root (`worktrees/<branch>`, gitignored) and, if services get started, assign each worktree a distinct port = `base + index` so parallel servers don't collide. ## Fan out one setup subagent per branch (parallel) Spawn all subagents at once with the Task tool. Give every subagent the same prompt, substituting only `BRANCH` and `PORT`: ``` Set up a git worktree for branch: BRANCH (assigned port: PORT, only relevant if you start a service) Follow the checklist in .claude/skills/worktree-create/references/worktree-setup.md. Concretely: 1. Create the worktree off the base branch: git worktree add worktrees/BRANCH -b BRANCH 2. Copy the gitignored config/secrets the project needs into worktrees/BRANCH (the env/config files detected for this repo; verify each with `git check-ignore` before copying). 3. Install dependencies with the project's detected package manager (every package, for a monorepo). 4. Run any generate/build step the app needs to boot (skip if none). 5. Verify: run the detected health check (start + hit the health endpoint on PORT if there is one, else a build/typecheck/test smoke). Then stop any server you started. Report exactly: worktree path · branch · deps installed (yes/no) · health check (PASS/FAIL) · any errors. ``` Fill the detected commands (install, env-file list, health check) into the template. For a single branch, run the steps directly instead of spawning. ## Aggregate and report Collect the reports and print a per-worktree summary (path · branch · deps · health · port), a combined `N worktree(s) ready` line, the next step (open each worktree / start a PIV loop in it), and the cleanup reminder: `git worktree remove worktrees/<branch>` once a branch is merged. If any worktree failed its health check, surface it clearly and do **not** report it ready. ## Resources - `references/worktree-setup.md` — the general, app-agnostic checklist of everything a fresh worktree needs, and how to detect each piece per project. Read it before detecting the setup.
Files in this package (2)
- SKILL.md 4 KB
- references/worktree-setup.md 5 KB
Versions
The database has no other skills named worktree-create.
Database snapshot: 13.11.2026 · package version b0fb2feed4d4 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100worktree-open
Create or reopen a git worktree for parallel development. Use when user wants to "open a worktree", "spin up a branch", "work on X separately", "work on this in parallel", "start a parallel task", "isolated environment for an agent", "side branch without switching", or mentions… - 100worktree
Creates git worktrees for isolated development. Use when user wants to "create a worktree", "start a new feature branch", "work on a fix in isolation", or needs a parallel development environment. - 95dev_manage_git-worktrees
Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification. Triggers: worktree, git worktree, isolated workspace, feature branch… - 100worktree
Use when creating or removing git worktrees for isolated parallel development. Handles provisioning of gitignored artifacts, env files, and post-create setup via jig.config.md configuration. - 100worktree
Create and setup a git worktree with all necessary files and dependencies. Use when starting work on a new feature branch. - 100ce-worktree
Set up isolated git worktrees — create a new branch for fresh work, or attach a worktree to an existing branch, PR, or commit. Use when starting isolated work or isolating an existing ref.