Agent skill · operations · onewave-ai
sub-agent-orchestrator
Manages parent/child agent relationships with task delegation and result aggregation. Supports sequential chains, parallel fans, conditional routing, retry logic, timeout handling, and YAML-based visual workflow definition.
Why this skill is useful
Adds a comprehensive YAML-based orchestration framework for managing complex multi-agent workflows with error handling and validation that the AI cannot generate on its own.
What it needs
Requires bash installed locally. About 2k tokens when loaded. Last updated 2026-07-15. 242 stars on the source repository.
What this skill does
Sub-Agent Orchestrator Design and execute multi-agent pipelines where each step is a different agent that depends on the previous one. Define roles, dependencies, and handoffs in YAML, then run sequential, parallel, conditional, loop, and map-reduce workflows with retry, timeout, and validation. Unlike Agent Army (homogeneous parallel code changes) and Agent Swarm (homogeneous parallel data processing), this orchestrator coordinates heterogeneous pipelines where the output of A feeds the input of B. Contents references/patterns.md -- The six workflow patterns and the comparison to Agent Army/Swarm. references/workflow-schema.md -- Full YAML workflow definition language. references/examples.md -- Complete worked workflows (research-to-proposal, lead scoring). references/execution-engine.md -- Per-step execution model, retry, timeout, validation, edge cases. references/templates.md -- Reusable workflow scaffolds. references/visual-and-reporting.md -- Text diagrams and the execution report template. Workflow 1. Determine the mode from the request: Run a workflow file: read the YAML at the given path. Define and run inline: convert the natural-language description into a workflow YAML (see references/workflow-schema.md), then show it for approval. Dry run: parse, validate, resolve inputs, and show the execution plan without deploying agents. Inspect: parse the YAML and produce a human-readable description plus a text diagram (see references/visual-and-reporting.md). 2. Parse and validate the workflow: confirm required fields, that agent IDs resolve, and that there are no circular dependencies. Report syntax or reference errors with the offending line. See references/execution-engine.md. 3. Resolve inputs: collect every required input from the user before starting; apply defaults for optional inputs. 4. Build the execution DAG and run each step in topological order using the matching execution model (sequential, parallel, conditional, loop, map). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills onewave-ai/sub-agent-orchestrator