agent-orchestrator
Runs multiple agents in parallel and merges their results with intelligent error handling, timeout management, and retry capabilities.
Agent Orchestrator Skill
When to use
Use when a task can be divided into independent sub‑jobs that benefit from concurrent execution by multiple agents (or agent instances).
Ideal scenarios:
- Research tasks requiring multiple perspectives or data sources
- Code generation or refactoring across multiple files/modules
- Data processing pipelines with parallelizable stages
- Testing scenarios requiring multiple test suites to run concurrently
- Any workload where sub‑tasks don't have strict sequential dependencies
What it does
- Provides a robust wrapper around the agent’s delegation/spawning mechanism (e.g.,
delegate_task,fork, orspawn). - Automatically collects stdout/stderr from each subagent and merges them into a single comprehensive report.
- Handles retries, timeouts, and graceful cancellation of stray subagents.
- Offers a shared scratch directory (configurable via
$ORCH_SCRATCHor similar) for intermediate data. - Emits a summary JSON file containing each subagent’s exit code, output size, and execution timing.
- Implements intelligent resource management to prevent system overload.
- Provides detailed failure diagnostics for troubleshooting.
Typical workflow
- Prepare a list of goal descriptions (strings) – one per subagent.
- Invoke the orchestrator with those goals, specifying any desired options (parallelism, timeout, retry behavior).
- Examine the merged report to see successes, failures, and performance metrics.
- If needed, re‑run only the failed subagents using the retry functionality.
- Use the shared scratch directory for intermediate data that needs to be exchanged between subagents.
Configuration
$ORCH_SCRATCH: Optional path to shared scratch directory for intermediate data- Default scratch directory: system temp directory with agent-orchestrator prefix
References
- Delegation patterns in agent frameworks: look for
delegate_task,spawn, orforkin your agent’s documentation. - Parallel computing patterns and best practices for distributed systems.
- Error handling and fault tolerance in concurrent systems.
Triggers
This skill activates when the user mentions:
- "run agents in parallel"
- "orchestrate multiple agents"
- "run tasks concurrently"
- "parallel agent execution"
- "multi-agent workflow"
- "delegate and merge results"
- "run multiple goals at once"
Related skills
- Downloads
- Security audit
- Pass
- Last updated
- 1w ago
- Current version
- v1.0.0
- License
- MIT-0
