worktree — community worktree, workmux, community, ide skills

v1.0.0

About this Skill

Perfect for Development Agents needing streamlined parallel development and automated workflow tasks in git worktrees Launch one or more tasks in new git worktrees using workmux.

raine raine
[0]
[0]
Updated: 3/12/2026

Killer-Skills Review

Decision support comes first. Repository text comes second.

Reference-Only Page Review Score: 7/11

This page remains useful for operators, but Killer-Skills treats it as reference material instead of a primary organic landing page.

Original recommendation layer Concrete use-case guidance Explicit limitations and caution Locale and body language aligned
Review Score
7/11
Quality Score
36
Canonical Locale
en
Detected Body Locale
en

Perfect for Development Agents needing streamlined parallel development and automated workflow tasks in git worktrees Launch one or more tasks in new git worktrees using workmux.

Core Value

Empowers agents to launch tasks in new git worktrees using workmux, streamlining parallel development and automating workflow tasks with git worktrees and workmux, enabling efficient task management and automation

Ideal Agent Persona

Perfect for Development Agents needing streamlined parallel development and automated workflow tasks in git worktrees

Capabilities Granted for worktree

Launching multiple development tasks in parallel git worktrees
Automating workflow tasks using workmux and git worktrees
Streamlining development workflows with automated task management in git worktrees

! Prerequisites & Limits

  • Requires git worktree setup
  • No codebase exploration or investigation allowed
  • Dependent on workmux for task automation

Why this page is reference-only

  • - The underlying skill quality score is below the review floor.

Source Boundary

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

After The Review

Decide The Next Action Before You Keep Reading Repository Material

Killer-Skills should not stop at opening repository instructions. It should help you decide whether to install this skill, when to cross-check against trusted collections, and when to move into workflow rollout.

Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is worktree?

Perfect for Development Agents needing streamlined parallel development and automated workflow tasks in git worktrees Launch one or more tasks in new git worktrees using workmux.

How do I install worktree?

Run the command: npx killer-skills add raine/workmux/worktree. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for worktree?

Key use cases include: Launching multiple development tasks in parallel git worktrees, Automating workflow tasks using workmux and git worktrees, Streamlining development workflows with automated task management in git worktrees.

Which IDEs are compatible with worktree?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for worktree?

Requires git worktree setup. No codebase exploration or investigation allowed. Dependent on workmux for task automation.

How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add raine/workmux/worktree. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use worktree immediately in the current project.

! Reference-Only Mode

This page remains useful for installation and reference, but Killer-Skills no longer treats it as a primary indexable landing page. Read the review above before relying on the upstream repository instructions.

Upstream Repository Material

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

Upstream Source

worktree

Install worktree, an AI agent skill for AI agent workflows and automation. Review the use cases, limitations, and setup path before rollout.

SKILL.md
Readonly
Upstream Repository Material
The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.
Supporting Evidence

Launch one or more tasks in new git worktrees using workmux.

Tasks: $ARGUMENTS

You are a dispatcher, not an implementer

HARD RULE — NO EXCEPTIONS: Do NOT explore, read, grep, glob, or search the codebase. Do NOT use the Task/Explore agent. Do NOT investigate the problem. You are a thin dispatcher — your ONLY job is to write prompt files and run workmux add. The worktree agent will do all the exploration and implementation.

If the user's message contains enough context to write a prompt, write it immediately. If not, ask the user for clarification — do NOT try to figure it out by reading code.

If tasks reference earlier conversation (e.g., "do option 2"), include all relevant context in each prompt you write.

If tasks reference a markdown file (e.g., a plan or spec), re-read the file to ensure you have the latest version before writing prompts.

For each task:

  1. Generate a short, descriptive worktree name (2-4 words, kebab-case)
  2. Write a detailed implementation prompt to a temp file
  3. Run workmux add <worktree-name> -b -P <temp-file> to create the worktree

The prompt file should:

  • Include the full task description
  • Use RELATIVE paths only (never absolute paths, since each worktree has its own root directory)
  • Be specific about what the agent should accomplish

Skill delegation

If the user passes a skill reference (e.g., /auto, /plan-review), the prompt should instruct the agent to use that skill instead of writing out manual implementation steps.

Skills can have flags. If the user passes /auto --gemini, pass the flag through to the skill invocation in the prompt.

Example prompt:

[Task description here]

Use the skill: /skill-name [flags if any] [task description]

Do NOT write detailed implementation steps when a skill is specified — the skill handles that.

Flags

--merge: When passed, add instruction to use /merge skill at the end to commit, rebase, and merge the branch.

...
Then use the /merge skill to commit, rebase, and merge the branch.

Workflow

Write ALL temp files first, THEN run all workmux commands.

IMPORTANT: Run workmux add from the CURRENT directory. Do NOT cd to the main repo or any other directory. The new worktree branches from whatever branch is checked out in the current directory.

Step 1 - Write all prompt files (in parallel):

bash
1tmpfile=$(mktemp).md 2cat > "$tmpfile" << 'EOF' 3Implement feature X... 4EOF 5echo "$tmpfile" # Note the path for step 2

Step 2 - After ALL files are written, run workmux commands (in parallel):

bash
1workmux add feature-x -b -P /tmp/tmp.abc123.md 2workmux add feature-y -b -P /tmp/tmp.def456.md

After creating the worktrees, inform the user which branches were created.

Remember: Your task is COMPLETE once worktrees are created. Do NOT implement anything yourself.

Related Skills

Looking for an alternative to worktree or another community skill for your workflow? Explore these related open-source skills.

View All

openclaw-release-maintainer

Logo of openclaw
openclaw

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

333.8k
0
AI

widget-generator

Logo of f
f

Generate customizable widget plugins for the prompts.chat feed system

149.6k
0
AI

flags

Logo of vercel
vercel

The React Framework

138.4k
0
Browser

pr-review

Logo of pytorch
pytorch

Tensors and Dynamic neural networks in Python with strong GPU acceleration

98.6k
0
Developer