← Back to Skills Marketplace
nextaltair

Subagent Spawn Command Builder

by Altair · GitHub ↗ · v0.1.4 · MIT-0
cross-platform ✓ Security Clean
1015
Downloads
0
Stars
12
Active Installs
5
Versions
Install in OpenClaw
/install subagent-spawn-command-builder
Description
Build sessions_spawn command payloads from JSON profiles. Use when you want reusable subagent profiles (model/thinking/timeout/cleanup/agentId/label) and com...
README (SKILL.md)

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

  • Builder script: scripts/build_spawn_payload.mjs
  • 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)
  • cwd (optional) — working directory for the subagent
  • mode (run|session, optional)

Setup

Read the "Subagent Spawn Profiles" table in TOOLS.md for default values per profile. Pass values as explicit CLI arguments (--model, --thinking, --run-timeout-seconds, --cleanup). The --profile flag is now a logging label, not a lookup key for a config file.

Generate payload

skills/subagent-spawn-command-builder/scripts/build_spawn_payload.mjs \
  --profile heartbeat \
  --task "Analyze recent context and return a compact summary" \
  --label heartbeat-test \
  --model claude-sonnet-4-20250514 \
  --thinking low \
  --run-timeout-seconds 300 \
  --cleanup delete

The script prints JSON directly usable for sessions_spawn.

Merge/priority rule

All values come from explicit CLI arguments. --profile is a logging label only (not a config lookup key). Refer to the "Subagent Spawn Profiles" table in TOOLS.md for recommended defaults per profile.

task always comes from CLI --task.

CLI options

Note: this builder is Node.js (.mjs) based. 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
  • --cwd \x3Cpath>
  • --mode run|session
Usage Guidance
This skill appears coherent and limited in scope: it only builds JSON payloads and logs them locally. Before installing, be aware that every run will append a JSON line to state/build-log.jsonl containing the full payload (including the --task text and any other flags you pass). If your tasks contain sensitive data or secrets, avoid passing them to this builder or ensure the state log is stored securely/cleaned up. Also note the script does not execute subagents or make network calls. If you rely on default profile values referenced in TOOLS.md, verify that TOOLS.md exists in your environment and provides the values you expect.
Capability Analysis
Type: OpenClaw Skill Name: subagent-spawn-command-builder Version: 0.1.4 The skill is a utility for generating JSON payloads for the 'sessions_spawn' command. The core logic in 'scripts/build_spawn_payload.mjs' is a straightforward CLI argument parser that outputs formatted JSON and logs the activity locally to 'state/build-log.jsonl'. No evidence of data exfiltration, remote execution, or malicious prompt injection was found.
Capability Assessment
✓ Purpose & Capability
Name/description match the included code and SKILL.md: the script builds a sessions_spawn payload JSON from CLI args and does not attempt to execute any spawn operation or call external services.
✓ Instruction Scope
SKILL.md and the script are narrowly scoped to parsing CLI args, constructing a payload object, writing a JSON log line to state/build-log.jsonl, and printing the payload to stdout. The instructions do not read unrelated system files or environment variables, nor do they send data to external endpoints.
✓ Install Mechanism
No install spec is provided (instruction-only with a small included Node script). There are no downloads or package installs; risk from installation is minimal.
✓ Credentials
The skill requests no environment variables, credentials, or config paths. All inputs come from CLI arguments, which is proportional to its stated purpose.
ℹ Persistence & Privilege
The script creates a local state directory and appends log lines to state/build-log.jsonl containing timestamp, profile label, and the generated payload (including the full task text and any provided fields). This is expected for a builder but means user-supplied text will be persisted on disk under the skill's state directory.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install subagent-spawn-command-builder
  3. After installation, invoke the skill by name or use /subagent-spawn-command-builder
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.4
- Added support for new payload parameters: cwd (working directory) and mode (run|session). - Updated CLI options to accept --cwd and --mode flags. - Documentation refreshed to reflect new fields and usage.
v0.1.3
refactor: migrate user config to TOOLS.md (#3)
v0.1.2
- Switched builder script from Python to Node.js: replaced build_spawn_payload.py with build_spawn_payload.mjs - Updated documentation and usage instructions to reference the new .mjs script - Removed Python references from setup and payload generation examples - Clarified that the builder is now Node.js-based in the CLI options section
v0.1.1
- Added a note recommending the use of python3 when specifying commands in generated tasks. - No functional code changes; updated documentation only.
v0.1.0
Initial release of subagent-spawn-command-builder. - Generates sessions_spawn command payloads from JSON profile configurations. - Supports reusable profiles for parameters like model, thinking, timeout, agentId, and label. - Command-line tool merges CLI arguments, profile values, and defaults to build the final JSON. - Does not execute sessions_spawn; only constructs and outputs the payload. - Includes setup instructions, file locations, and all supported parameter options.
Metadata
Slug subagent-spawn-command-builder
Version 0.1.4
License MIT-0
All-time Installs 12
Active Installs 12
Total Versions 5
Frequently Asked Questions

What is Subagent Spawn Command Builder?

Build sessions_spawn command payloads from JSON profiles. Use when you want reusable subagent profiles (model/thinking/timeout/cleanup/agentId/label) and com... It is an AI Agent Skill for Claude Code / OpenClaw, with 1015 downloads so far.

How do I install Subagent Spawn Command Builder?

Run "/install subagent-spawn-command-builder" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Subagent Spawn Command Builder free?

Yes, Subagent Spawn Command Builder is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Subagent Spawn Command Builder support?

Subagent Spawn Command Builder is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Subagent Spawn Command Builder?

It is built and maintained by Altair (@nextaltair); the current version is v0.1.4.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments