Xpersona
Claim this agent
agentCLAWHUBUnverified

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...

OpenClaw
View on ClawHub

Rank

62

Safety

84

Downloads

451

Updated

Apr 15, 2026

Version

0.1.2

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 451 downloads reported by the source. Last updated 4/15/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Apr 15, 2026
Protocol compatibility
OpenClawcompatibility · observed Apr 15, 2026
Adoption signal
451 downloadsadoption · observed Apr 15, 2026
Latest release
0.1.2release · observed Feb 14, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn747bx1r2jrbbyca61v6k06397zy93t:subagent-spawn-command-builder
  1. Install using `clawhub skill install kn747bx1r2jrbbyca61v6k06397zy93t:subagent-spawn-command-builder` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-nextaltair-subagent-spawn-command-builder/snapshot"

Documentation

CLAWHUB

10,391 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: 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 command-ready JSON without executing spawn.
---

# 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.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)

## 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
skills/subagent-spawn-command-builder/scripts/build_spawn_payload.mjs \
  --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:

1. CLI option (`--model`, `--thinking`, etc.)
2. Profile value (`profiles.<name>.*`)
3. Defaults value (`defaults.*`)

`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`

README.md

# subagent-spawn-command-builder

`sessions_spawn` を**実行せず**、コマンド用payload JSONだけを生成するスキルです。

## 作成意図

このスキルは、以下の課題を解消するために作成しました。

- subagent呼び出し時の `model/thinking/timeout/cleanup` を毎回手で書くとミスが増える
- `agents.list` 依存の運用は、single-agent中心の使い方では設定コストが高い
- 実行まで1つのスキルに含めると責務が重くなり、トラブル時の切り分けが難しくなる

そのため、**「実行」と「生成」を分離**し、このスキルは

- プロファイル(JSON)管理
- `sessions_spawn` payload生成

だけに責務を限定しています。

## 目的

- subagent実行パラメータをJSONプロファイルで管理する
- `sessions_spawn` に渡すJSONを安定して生成する
- 実行は呼び出し側に任せる(このスキルは生成専用)

## 対応パラメータ

生成するpayloadは以下を扱います。

- `task` (required)
- `label` (optional)
- `agentId` (optional)
- `model` (optional)
- `thinking` (optional)
- `runTimeoutSeconds` (optional)
- `cleanup` (`keep|delete`, optional)

## ファイル構成

- テンプレート: `state/spawn-profiles.template.json`
- 実運用設定: `state/spawn-profiles.json`
- 生成スクリプト: `scripts/build_spawn_payload.mjs`
- 生成ログ: `state/build-log.jsonl`

## 使い方

### 1) テンプレートをコピー

```bash
cp skills/subagent-spawn-command-builder/state/spawn-profiles.template.json \
   skills/subagent-spawn-command-builder/state/spawn-profiles.json
```

### 2) `spawn-profiles.json` を編集

`model` などを自分の環境に合わせて設定。

### 3) payloadを生成

```bash
skills/subagent-spawn-command-builder/scripts/build_spawn_payload.mjs \
  --profile heartbeat \
  --task "Analyze recent context and return a compact summary" \
  --label heartbeat-test
```

## 値の優先順位

同じ項目が複数場所にある場合、次の順で採用されます。

1. CLI引数(`--model` など)
2. `profiles.<name>.*`
3. `defaults.*`

`task` は必ずCLIの `--task` を使います。

## 注意

- このスキルは payload/command 生成専用です
- `sessions_spawn` の実行はこのスキルの責務外です
- Python実行コマンドをtaskに含める場合は `python3` を使ってください(`python` は環境によって未定義)。

_meta.json

{
  "ownerId": "kn747bx1r2jrbbyca61v6k06397zy93t",
  "slug": "subagent-spawn-command-builder",
  "version": "0.1.2",
  "publishedAt": 1771029448201
}

state/spawn-profiles.template.json

{
  "version": 1,
  "defaults": {
    "label": "",
    "agentId": "",
    "model": "",
    "thinking": "",
    "runTimeoutSeconds": 0,
    "cleanup": "keep"
  },
  "profiles": {
    "heartbeat": {
      "label": "heartbeat-default",
      "agentId": "",
      "model": "<set-by-user>",
      "thinking": "low",
      "runTimeoutSeconds": 180,
      "cleanup": "keep"
    },
    "journal": {
      "label": "journal-default",
      "agentId": "",
      "model": "<set-by-user>",
      "thinking": "high",
      "runTimeoutSeconds": 300,
      "cleanup": "keep"
    }
  }
}

Related agents

Same protocol, similar job.

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceUrl": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-nextaltair-subagent-spawn-command-builder/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-nextaltair-subagent-spawn-command-builder/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "451 downloads",
      "href": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceUrl": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.1.2",
      "href": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceUrl": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-14T00:37:28.201Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-nextaltair-subagent-spawn-command-builder/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-nextaltair-subagent-spawn-command-builder/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.1.2",
      "description": "- 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",
      "href": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceUrl": "https://clawhub.ai/NEXTAltair/subagent-spawn-command-builder",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-14T00:37:28.201Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to Subagent Spawn Command Builder and adjacent AI workflows.