Multi-Agent Orchestrator
Intelligently coordinate multiple AI agents in parallel for complex tasks. Auto-analyzes requirements, selects optimal agent combinations, and synthesizes results.
Features
✅ Smart Routing — Analyzes task keywords to select 1-3 best agents ✅ Parallel Execution — Runs agents simultaneously, not sequentially ✅ Silent Failure Handling — Continues with available results if an agent fails ✅ 4 Operating Modes — Auto, Review, Challenge, Consult ✅ Synthesized Reports — Combines multiple perspectives into decisive recommendations ✅ Multi-Language Support — Understands English, 中文, 日本語, 한국어
Quick Start
Default (Auto Mode)
User describes task → Claude auto-routes to best agents:
User: "審查這個認證流程,有沒有安全漏洞"
Claude: 分析 → 選擇 codex + cline (並行)
Output: Cross-review report
Explicit Invocations
Review Mode — Code cross-review:
/agents review
Challenge Mode — Adversarial debate:
/agents challenge
Consult Mode — Specify agents:
/agents consult kilo,gemini
Available Agents
| Agent | Specialty |
|---|---|
| codex | Code review, refactoring, security, tests |
| gemini | Architecture, design patterns, broad knowledge |
| kilo | Logic, system design, complex reasoning |
| cline | Implementation details, structured analysis |
| opencode | Rapid prototyping, code completion, automation |
| qoder | Information retrieval, documentation, knowledge base |
Task Classification
Automatically detects and routes:
- Code Review → codex + gemini
- Feature Implementation → cline + opencode
- Architecture Design → kilo + gemini
- Analysis → gemini + kilo
- Prototyping → opencode + cline
- Knowledge Lookup → qoder + gemini
- Security Audit → codex + cline
- Debugging → codex + kilo
Installation
Project Level
# Already installed at:
# ~/YD 2026/.claude/skills/agents/
Global Installation (via triple-publish)
cd ~/YD\ 2026/.claude/skills/agents/
/triple-publish # Deploy to GitHub + npm + PyPI
Or manually:
# Copy to global skills
cp -r ~/YD\ 2026/.claude/skills/agents/ ~/.claude/skills/agents/
Output Format
All modes produce structured reports:
## 🤖 Multi-Agent Report
**Task**: [description]
**Mode**: Auto | Review | Challenge | Consult
**Agents Called**: codex, gemini
**Duration**: ~45s
### Agent 1 [PASS|CONCERNS|BLOCK]
...
### Agent 2 [PASS|CONCERNS|BLOCK]
...
### Synthesis
**Consensus**: ...
**Disagreement**: ...
**Blind Spots**: ...
**Conclusion**: [PASS | APPROVE_WITH_CHANGES | BLOCK]
**Claude's Take**: ...
Auto-Trigger Scenarios
The orchestrator automatically uses multiple agents when:
| Scenario | Trigger | Agents |
|---|---|---|
| Code review / PR | Large changes (>100 lines) | codex + gemini |
| Architecture decision | Major refactor, new pattern | gemini + kilo |
| Security-sensitive changes | auth, crypto, secrets | codex + cline |
| Debugging | Stuck for 3+ turns | codex or kilo |
| User requests "second opinion" | Explicit mention | Best 1-2 agents |
Reliability
Constraints Respected
- ✅ Rate limit awareness (skip qoder on frequent runs)
- ✅ Context efficiency (keep prompts <2000 chars)
- ✅ Timeout protection (60s per agent, 90s total)
- ✅ Budget management (qoder: 1-2 runs/week)
Failure Handling
- 1 agent fails → Use available agent's output + note limitation
- All agents fail → Report reason (timeout, rate limit, network)
- Never silently drop results
Configuration
Enable in Claude Code
The skill is available by default. To verify:
# Check installation
cat ~/.claude/skills/agents/SKILL.md | head -20
# Or in Claude Code
/agents consult gemini "what's your favorite algorithm?"
Per-Project Settings
Add to .claude/settings.json:
{
"enabledPlugins": {
"agents-skill@builtin": true
}
}
Examples
Example 1: Auto Code Review
User: "Help me review this authentication module"
→ Auto-detects: code review task
→ Routes to: codex (code quality) + gemini (design)
→ Output: Combined report with security & architecture insights
Example 2: Challenge Mode
User: "/agents challenge Should we use microservices?"
→ Auto-selects: gemini (pro) vs kilo (con)
→ Output: Debate exposing trade-offs and blind spots
Example 3: Consult Specific Agents
User: "/agents consult kilo,cline Design this database schema"
→ Routes only to: kilo + cline
→ Output: Focused analysis on both architectural & implementation aspects
Troubleshooting
Agent not responding
- Check if agent is installed:
<agent> --version - Check authentication: run agent login script
- Check rate limits: some agents have weekly quotas
- Wait a moment and retry
Slow execution
- Parallel execution normally takes 30-90s total
- If >120s, one agent likely timed out (check /tmp logs)
- Reduce task complexity for faster response
Missing results
- Check if required agent is available:
/agents consult qoder test - Some agents have budget limits (qoder: 1-2/week)
- Skip unavailable agents and use others' results
Architecture
SKILL.md
├── Mode 1: Auto (keyword matching → agent selection)
├── Mode 2: Review (codex + gemini parallel)
├── Mode 3: Challenge (adversarial debate)
└── Mode 4: Consult (manual agent selection)
└── Parallel Bash Execution
├── Silent failure handling
├── Result aggregation
└── Synthesis & reporting
Future Enhancements
- Learning from past runs (which agents usually agree/disagree)
- Dynamic budget allocation (adjust agents based on available quota)
- Streaming output (show results as agents finish)
- Custom agent combinations via YAML config
- Integration with CI/CD for automatic code review
Version History
v1.1.1 (2026-03-27)
- Renamed GitHub repo to orchestrator-agents-skill
- Updated all URLs and references to new repo name
- All 6 agent CLIs upgraded to latest versions
v1.1.0 (2026-03-27)
- Independent repo release with full triple-publish (GitHub + npm + PyPI)
- Synced local skill directory with all project files
- Documentation and version consistency improvements
v1.0.0 (2026-03-26)
- Initial release
- 4 modes: Auto, Review, Challenge, Consult
- Support for 6 agents (codex, cline, gemini, kilo, opencode, qoder)
- Parallel execution with silent failure handling
- Multi-language keyword matching
License
MIT — See LICENSE file
Contributing
This skill is maintained as part of YD 2026 Project. To contribute:
- Fork from
~/.claude/skills/agents/ - Test thoroughly (all 4 modes)
- Submit changes via standard PR workflow
- Deploy via
/triple-publishwhen approved
Ready to use: Just describe your task and Claude will automatically coordinate the right agents!
Metadata
Release files for orchestrator-agents-skill 1.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| orchestrator_agents_skill-1.1.1.tar.gz | 5.5 kB | Without provenance | Details for orchestrator_agents_skill-1.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| orchestrator_agents_skill-1.1.1-py3-none-any.whl | Python 3 | none | any | Details for orchestrator_agents_skill-1.1.1-py3-none-any.whl |
Total release size: 11.1 kB
Release files / orchestrator_agents_skill-1.1.1.tar.gz
| Download URL | orchestrator_agents_skill-1.1.1.tar.gz |
|---|---|
| Size | 5.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
925adcaac9bf2955e03b445ac02e44c1d480602a11b27366ef535197a4bbbc8a
|
|
BLAKE2b-256 checksum How to use checksums |
3f14149b20ff91fb08f7f6a40126844de0f43c0e71dde9fd7369a008d189ad06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Release files / orchestrator_agents_skill-1.1.1-py3-none-any.whl
| Download URL | orchestrator_agents_skill-1.1.1-py3-none-any.whl |
|---|---|
| Size | 5.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
221eba99ceccbf135a418cc45721a2ffeed3ea6cac87aa05b6b112880a00356f
|
|
BLAKE2b-256 checksum How to use checksums |
4a83aec6bbfe05d6a3c871b2068f8227b724ca94952a1fa97289fd05f80cb3bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.3
|
Security for orchestrator-agents-skill 1.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.