subagent-spawn-command-builder
Generate sessions_spawn payload JSON from profile config.
This skill does not execute sessions_spawn; it only builds payload/command JSON.
Files
- •Profile template:
state/spawn-profiles.template.json - •Active profile config:
state/spawn-profiles.json - •Builder script:
scripts/build_spawn_payload.py - •Builder log:
state/build-log.jsonl
Supported sessions_spawn parameters
- •
task(required) - •
label(optional) - •
agentId(optional) - •
model(optional) - •
thinking(optional) - •
runTimeoutSeconds(optional) - •
cleanup(keep|delete, optional)
Setup
bash
cp skills/subagent-spawn-command-builder/state/spawn-profiles.template.json \ skills/subagent-spawn-command-builder/state/spawn-profiles.json
Then edit spawn-profiles.json.
Generate payload
bash
python3 skills/subagent-spawn-command-builder/scripts/build_spawn_payload.py \ --profile heartbeat \ --task "Analyze recent context and return a compact summary" \ --label heartbeat-test
The script prints JSON directly usable for sessions_spawn.
Merge/priority rule
Value resolution order is:
- •CLI option (
--model,--thinking, etc.) - •Profile value (
profiles.<name>.*) - •Defaults value (
defaults.*)
task always comes from CLI --task.
CLI options
Note: if generated tasks include Python execution steps, write commands with python3 (not python).
- •
--profile(required) - •
--task(required) - •
--label - •
--agent-id - •
--model - •
--thinking - •
--run-timeout-seconds - •
--cleanup keep|delete