shunk031-herdr-orchestrate-workers

Installation
SKILL.md

[!NOTE] After reading this SKILL.md, say: 🐑 I read shunk031-herdr-orchestrate-workers.

Orchestrate Herdr Workers

An orchestrator delegates independent tasks to worker agents, one git worktree tab each. Workers must report back by prompting the orchestrator for attribution and audit, but completion is collected from Herdr lifecycle state and the worker's deliverable and transcript. Read this skill file and the herdr skill first: the herdr skill owns all CLI mechanics, JSON responses, ID handling, and safety rules. This skill adds only the orchestration protocol. When one session oversees multiple root orchestrators, pair this with the shunk031-herdr-meta-orchestrate skill for root inventory, status requests, and relays. When writing a Codex worker's task prompt, follow the shunk031-codex-worker-prompting skill. Build every peer prompt in a shell variable first (for example, with a quoted heredoc) and pass it as one argument; never let the shell expand task or report text.

Send only into an empty input

Before every prompt send in this skill, run the guarded sender at ~/.agents/skills/shunk031-herdr-orchestrate-workers/scripts/herdr-agent-prompt-if-input-empty.sh with the target and a quoted message variable instead of calling herdr agent prompt directly. The helper resolves the target pane with herdr agent get, reads herdr pane read --source visible --format ansi, and uses herdr agent prompt as the transport only when the current ❯ or › input line has no non-dim text. Treat placeholder or suggestion text styled with ANSI \e[2m after the prompt glyph as empty. It checks immediately, then waits 30 seconds and rechecks up to five times; if the input remains occupied or cannot be read, it leaves the message unsent and prints the full message as undelivered.

Set up the orchestrator

  1. Name yourself so workers can address you, and label your tab. Pick a short name that is free in herdr agent list; names cap at 32 characters:

    herdr agent rename "$HERDR_PANE_ID" orch
    herdr tab rename "$HERDR_TAB_ID" "🤖 Orchestrator"
    
Installs
60
Repository
shunk031/skills
First Seen
Aug 28, 2026