New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Worktree Create

by coleam00 in coleam00/skills

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…

MITAuto-check passedDevelopment

Install Worktree Create

skills CLI
$ npx skills add coleam00/skills --skill worktree-create -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install coleam00/skills worktree-create --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/coleam00/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/worktree-create .claude/skills/worktree-create && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
worktree-create
GitHub stars
670
Token cost
~958 tokens
SKILL.md length
355 words
Files
2 (incl. references)
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Starting isolated parallel work
  • SKILL.md covers Input, Detect the project setup ONCE,…, Fan out one setup subagent per… and Aggregate and report, plus 1 more section
  • Calls git
  • Running several PIV loops at once

What it does

Worktree Create is an agent skill from coleam00/skills. 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.

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/worktree-setup.md`).

It sits in Development, covering Git worktrees. The repository describes itself as: The agent skills I actually use to build software with coding agents. The PIV loop, planning, worktrees, and the meta-skills for building your own AI Layer. The licence is MIT.

When your agent uses it

  • Starting isolated parallel work
  • Running several PIV loops at once
  • The user says set up worktrees
  • Create a worktree

Example prompts

  • “set up worktrees”
  • “create a worktree”
  • “spin up parallel branches”
  • “/worktree-create”

What it can do on your machine

Read from SKILL.md and the folder at commit dfaa910. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Worktree Create loads about 958 tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 105 tokens; SKILL.md has 355 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~958
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from coleam00/skills at commit dfaa910, republished under its MIT licence (© coleam00). 355 words, ~958 tokens.

Download SKILL.mdSave it as .claude/skills/worktree-create/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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.

Show full SKILL.md (140 more words)Show less

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.

© coleam00, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .claude/skills/worktree-create of coleam00/skills.

  • SKILL.md
  • references/worktree-setup.md

Open the folder on GitHubat commit dfaa910

Compare with similar skills

Worktree Create next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Worktree Create compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Worktree Create this skillcoleam00/skills670—~958Automated safety check: PassMIT
Migrate Core Code to Submodulestinyhumansai/openhuman41k—~2.6kAutomated safety check: PassGPL-3.0
Nagentdavidondrej/skills4.1k—~1.7kAutomated safety check: NotesMIT
Git Worktree IsolationjnMetaCode/superpowers-zh8.3k1 repos~982Automated safety check: PassMIT
WorktreeAgentsMesh/AgentsMesh2.4k—~553Automated safety check: NotesCustom licence
Cursor Composer Task DelegateChachamaru127/claude-code-harness3.2k—~4.4kAutomated safety check: NotesMIT

Similar skills

  • Migrate Core Code to Submodules

    tinyhumansai/openhuman

    Plans and carries out moving non-host-specific code and its tests from the OpenHuman core into vendored tiny submodule libraries, then releases the submodule and re-pins the host.

    41k GitHub stars~2.6k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Nagent

    davidondrej/skills

    Launch a new bb worker thread with the right project, model, worktree, and task brief.

    4.1k GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check: notes

  • Git Worktree Isolation

    jnMetaCode/superpowers-zh

    Sets up an isolated workspace before feature work or plan execution, preferring native worktree tools and falling back to git worktree, with instructions in Chinese.

    8.3k GitHub starsUsed in 1 repo~982 tokens
    DevelopmentAuto-check passed

  • Worktree

    AgentsMesh/AgentsMesh

    Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.

    2.4k GitHub stars~553 tokensUpdated 14 days ago
    DevelopmentAuto-check: notes

  • Cursor Composer Task Delegate

    Chachamaru127/claude-code-harness

    Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.

    3.2k GitHub stars~4.4k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes

  • Git Worktree Setup

    k8zdev/k8z

    Automate git worktree creation and copy private files (not tracked in git) to new workdirs.

    155 GitHub stars~930 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed

More from coleam00/skills

All 33 skills in this repo

  • Ablate AI Layer

    coleam00/skills

    Measure whether a repository's AI instructions still earn their place, by running the same real task many times with the layer intact and with it stripped, then grading every rule against what…

    670 GitHub stars~1.9k tokensUpdated 20 days ago
    Auto-check passed

  • Build Dark Factory

    coleam00/skills

    Take a PRD and build a dark factory around it - a repository that takes work in as an issue and ships validated code out with nobody at the keyboard - one component at a time, into the user's actual…

    670 GitHub stars~12k tokensUpdated 20 days ago
    Auto-check passed

  • Drive Screen

    coleam00/skills

    Take real control of the desktop - list and focus windows, type, paste, click, scroll, and screenshot - on Windows, macOS or Linux, and drive other coding-agent sessions running in terminals.

    670 GitHub stars~5.4k tokensUpdated 20 days ago
    Auto-check passed

  • Second Brain Audit

    coleam00/skills

    Audit any second brain, notes folder, or agent memory for facts that have quietly stopped being true, then fix the worst one so it stops recurring.

    670 GitHub stars~4.6k tokensUpdated 20 days ago
    Auto-check passed

  • Hooks Create

    coleam00/skills

    Author a working Claude Code hook from a plain-English description of what it should guarantee or do.

    670 GitHub stars~3.6k tokensUpdated 20 days ago
    Auto-check: notes

  • Piv Implement

    coleam00/skills

    Executes an implementation plan task-by-task with validation at every step.

    670 GitHub stars~1k tokensUpdated 20 days ago
    Auto-check passed

Categories

Questions about Worktree Create

What does Worktree Create do?

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 Create is an agent skill from coleam00/skills. 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.

When should I use Worktree Create?

Worktree Create fits situations like: starting isolated parallel work; running several PIV loops at once; the user says set up worktrees; create a worktree.

How do I install Worktree Create in Claude Code?

Run `npx skills add coleam00/skills --skill worktree-create -a claude-code`. Or copy the skill folder (.claude/skills/worktree-create in coleam00/skills) into .claude/skills/worktree-create in your project. Claude Code loads it when a task matches its description.

How do I install Worktree Create in Codex?

Run `npx skills add coleam00/skills --skill worktree-create -a codex`. Or copy the skill folder (.claude/skills/worktree-create in coleam00/skills) into .agents/skills/worktree-create in your project. Codex loads it when a task matches its description.

Can I use Worktree Create in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add coleam00/skills --skill worktree-create -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/worktree-create, .gemini/skills/worktree-create, .github/skills/worktree-create and .opencode/skills/worktree-create in your project.

What does Worktree Create need to run?

Going by SKILL.md and its folder, Worktree Create needs the command-line tools its instructions call (git).

Does Worktree Create access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Worktree Create safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Worktree Create use?

Worktree Create is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Worktree Create use?

About 958 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.3k tokens, read only when the agent opens those files.

What are the alternatives to Worktree Create?

Skills that share tags, products or a category with Worktree Create: Migrate Core Code to Submodules (tinyhumansai/openhuman, 41k stars), Nagent (davidondrej/skills, 4.1k stars), Git Worktree Isolation (jnMetaCode/superpowers-zh, 8.3k stars) and Worktree (AgentsMesh/AgentsMesh, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Worktree Create?

coleam00 (a GitHub user) maintains it in coleam00/skills, which has 670 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on September 17, 2026.

Source: coleam00/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.