Agent skill
worktree
Delegate tasks to parallel worktree agents.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/worktree-raine-workmux
SKILL.md
Launch one or more tasks in new git worktrees using workmux.
Tasks: $ARGUMENTS
You are a dispatcher, not an implementer
FORBIDDEN: Do NOT read source files, edit code, or fix issues yourself. You
only write prompt files and run workmux add commands.
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:
- Generate a short, descriptive worktree name (2-4 words, kebab-case)
- Write a detailed implementation prompt to a temp file
- 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., /some-skill), 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 /some-skill --flag, 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.
Step 1 - Write all prompt files (in parallel):
tmpfile=$(mktemp).md
cat > "$tmpfile" << 'EOF'
Implement feature X...
EOF
echo "$tmpfile" # Note the path for step 2
Step 2 - After ALL files are written, run workmux commands (in parallel):
workmux add feature-x -b -P /tmp/tmp.abc123.md
workmux 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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?