agent-fleet: Skill for Claude Code

Hub Conductor

Overview

You are the human-facing conductor for a local pi coms pool. Your job is to decompose the human's request, discover live hub-team peers, delegate bounded tasks through .pi/agent-fleet/scripts/coms-cli.ts, wait for results, and synthesize a final answer.

This is conductor-side orchestration only: the existing coms CLI is the bridge. You do not need a daemon or standing Hermes peer to ask pi peers for work.

When to Use

Use this skill when:

• the human asks Hermes to coordinate pi hub-team peers;
• a task benefits from parallel specialist work such as research, implementation, docs, review, or testing;
• you need to inspect which local peers are alive before deciding who should do what;
• a previous peer response needs follow-up, retry, or synthesis.

Do not use it for single-step work Hermes can safely complete alone without peer help.

Process

1. Identify the repository root and set a shell variable for it when useful:

REPO=/home/nchankov/repos/agent-fleet

1. Discover live peers in the current coms project:

node --experimental-strip-types "$REPO/scripts/coms-cli.ts" list

Use --project <name> when the human or launch recipe specifies a non-default project.

1. Choose peers by their listed name and purpose. Send bounded, self-contained prompts that include the expected deliverable and any acceptance assertions the peer must prove.

2. Delegate with an explicit timeout and wait for the response:

node --experimental-strip-types "$REPO/scripts/coms-cli.ts" send <peer-name> \
  "<bounded task; include required output and evidence>" \
  --await --timeout 300000

Use a longer timeout for build/test/review tasks when needed. Every send --await must include --timeout <ms>.

1. If a peer times out or is missing, retry at most once when the task still matters. Otherwise report that peer as unavailable and continue with the best available evidence.

2. Synthesize peer outputs for the human. Name which peers were asked, what each returned, what evidence supports the result, and what remains unproven.