1 files changed, 14 insertions, 0 deletions
diff --git a/skills/agent-orchestration.json b/skills/agent-orchestration.json
new file mode 100644
index 0000000..a4f860d
--- /dev/null
+++ b/skills/agent-orchestration.json
@@ -0,0 +1,14 @@
+{
+  "name": "agent-orchestration",
+  "description": "How to use the agent registry, leases, and orchestrator for multi-agent workflows",
+  "tags": [
+    "agents",
+    "orchestration",
+    "delegation",
+    "leases"
+  ],
+  "category": "system",
+  "created": "2026-06-06T02:32:54.007Z",
+  "updated": "2026-06-06T04:17:00.189Z",
+  "content": "---\nname: agent-orchestration\ndescription: How to use the agent registry, leases, and orchestrator for multi-agent workflows\ntags: [agents, orchestration, delegation, leases]\ncategory: system\n---\n## Steps\n1. **Agent Registry:**\n   - agent-list — list all registered agents (ID, type, capabilities, status)\n   - agent-register <type> <capabilities> — register a new agent (capabilities: comma-separated like \"code,research\")\n   - agent-unregister <id> — remove an agent\n   - agent-status <id> — detailed status including uptime, task history\n\n2. **Leases (time-bound contracts):**\n   - lease-create <agent-id> <ttl-seconds> — create a lease with watchdog timer\n   - lease-list — show active leases with remaining TTL\n   - lease-revoke <lease-id> — terminate a lease early\n   - lease-renew <lease-id> <ttl-seconds> — extend a lease\n\n3. **Orchestrator (spawn, delegate, kill):**\n   - orchestrator-spawn <type> <capabilities> — spawn a new agent automatically (registers + creates lease)\n   - orchestrator-kill <agent-id> — kill an agent (revokes lease + unregisters)\n   - orchestrate — list all active agents with their orchestrator state\n   - orchestrator-purge — kill all idle/expired agents\n   - orchestrator-status — full system status: active, idle, dead agents\n\n4. **AI tool integration:**\n   - AI tools list_agents, delegate_task, spawn_agent are available in the AI system prompt\n   - The AI can auto-spawn worker agents for sub-tasks\n   - Each agent gets its own VFS workspace at /agents/<agent-id>/\n\n5. **When to use:**\n   - User needs parallel task execution → orchestrator-spawn coder + researcher\n   - Time-bound automation → lease-create with short TTL\n   - System cleanup → orchestrator-purge to kill stale agents"
+}
+\ No newline at end of file