orchestration

Coordinate supervised Orca workers with task DAGs, threaded messages, and decision gates.

Updated Nov 25, 2024
One-click install
npx skills add https://github.com/cbrostrom/dotfiles --skill orchestration-cbrostrom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orchestration
Source: https://github.com/cbrostrom/dotfiles/tree/main/stow/agents/.agents/skills/orchestration
Command: npx skills add https://github.com/cbrostrom/dotfiles --skill orchestration-cbrostrom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple AI agents on a shared codebase requires structured supervision: dispatching tasks, waiting on worker completion or escalations, gating decisions, and decomposing work across agents. This Skill provides the Orca orchestration workflow so an agent can act as a coordinator over supervised Orca workers instead of improvising ad-hoc handoffs. ## Core Features & Use Cases - Supervised worker coordination: Send threaded messages, use blocking ask/reply flows, dispatch tasks, and wait on worker_done or escalation events. - Task DAGs and decision gates: Decompose work across agents, define task dependencies, and run coordinator loops with conditional action gates. - Version-matched guidance: Loads the exact orchestration reference served by the installed Orca binary via ORCA skills get orchestration, so instructions never drift from the runtime. - Use Case: A user asks to split a feature across three agents in separate worktrees, monitor their progress, and gate the merge on review approval — the coordinator dispatches tasks, waits on worker_done events, and applies the decision gate. ## Quick Start Ask the agent to coordinate multiple Orca workers on a task DAG, then have it run the resolved Orca executable's skills get orchestration command to load the version-matched guide before dispatching any work.

Frequently Asked Questions about orchestration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple Orca agents on one task?▼

Use the Orca orchestration workflow to dispatch tasks to supervised workers, then wait on worker_done or escalation events. Load the version-matched guide first with the resolved Orca executable's skills get orchestration command.

When should I use orchestration instead of orca-cli handoffs?▼

Use orchestration when you need to supervise, monitor, or coordinate a DAG of workers. Use orca-cli for full ownership handoffs, plain terminal control, shell commands, and worktree management without supervision.

Which Orca executable should I run on Linux?▼

On Linux outside an Orca-managed terminal, use orca-ide. Running bare orca there typically resolves to the GNOME Orca screen reader and starts speech on the user's machine.

Why does the Orca skills get command fail?▼

If skills get is unknown, the installed Orca version predates the feature and updating Orca restores the guide. If Orca is not running, start it with ORCA open --json and retry the command.

Can I use a non-Orca subagent tool for coordination?▼

No. Coordination requires real Orca runtime state such as worker_done events and escalation waits, so substituting a non-Orca subagent tool will not work for supervised multi-agent flows.