spawn-agent
Installation
SKILL.md
spawn-agent
Essential Principles
- The script does the Herdr work; you resolve the inputs.
scripts/spawn-agent.shcreates the tab, starts the agent in it, retries busy panes, suffixes colliding handles, closes the tab if the agent never starts, and sends at most one prompt. - The parameters come from the user's words or a calling skill's explicit values, never from what a value resembles. An inferred value looks helpful and produces a session nobody asked for.
- The new session inherits only cwd. Its context is empty, so a task the user stated can only reach it as a prompt. When they stated none, an empty session waiting for their input is the intended result, not a gap to fill.
Parameters
| Param | Flag | Required | Default |
|---|---|---|---|
name |
--name |
yes | - |
kind |
--kind |
yes | the harness running this skill: Claude Code → claude, Codex → codex, pi → pi |
model |
--model |
no | omitted, so the session starts on that agent's default |
task |
--task |
no | none |
focus |
--focus / --no-focus |
no | derived from task by the script |
name is free text (spaces and capitals are fine). It becomes the tab label, the session display name, and, slugified, the Herdr handle. Use it exactly as given. If it's missing and can't be inferred from the request, ask rather than inventing one.