Execute orchestrate multi-agent systems with handoffs, routing, and workflows across AI providers. Use when building complex AI systems requiring agent collaboration, task delegation, or workflow coordination. Trigger with phrases like "create multi-agent system", "orchestrate agents", or "coordinate agent workflows".
68
62%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/ai-ml/ai-sdk-agents/skills/orchestrating-multi-agent-systems/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description is strong in completeness and trigger term coverage, with explicit 'Use when' and 'Trigger with' clauses and good natural keywords. Its main weakness is the slightly vague and grammatically awkward capability listing ('Execute orchestrate' appears to be a typo/error), which reduces specificity. The domain niche is well-defined, making it distinctive.
Suggestions
Fix the grammatical error 'Execute orchestrate' and list more concrete actions, e.g., 'Define agent roles, configure handoff rules, set up routing logic, and manage workflows across AI providers.'
Add specific file types, frameworks, or protocols if applicable (e.g., 'OpenAI Swarm, LangGraph, AutoGen') to further increase specificity and trigger term quality.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (multi-agent systems) and mentions some actions (handoffs, routing, workflows), but the actions are somewhat abstract rather than concrete. 'Execute orchestrate' is grammatically awkward and unclear. It doesn't list specific concrete operations like 'define agent roles, configure handoff rules, set up routing logic.' | 2 / 3 |
Completeness | Clearly answers both 'what' (orchestrate multi-agent systems with handoffs, routing, and workflows across AI providers) and 'when' (explicit 'Use when' clause and 'Trigger with phrases' clause providing concrete trigger guidance). | 3 / 3 |
Trigger Term Quality | Includes good natural trigger terms: 'multi-agent system', 'orchestrate agents', 'coordinate agent workflows', 'handoffs', 'routing', 'task delegation', 'workflow coordination', 'AI providers'. These are terms users would naturally use when seeking this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | The description targets a clear niche—multi-agent orchestration with handoffs and routing across AI providers. This is specific enough to be distinguishable from general AI/coding skills or single-agent tools, with distinct trigger terms unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill has reasonable structure and covers the right topics for multi-agent orchestration, but critically lacks any executable code examples—the core weakness. The instructions read like a high-level architecture document rather than actionable guidance Claude can follow. The referenced bundle files don't exist, undermining the progressive disclosure strategy.
Suggestions
Add concrete, executable TypeScript code examples for at minimum: defining an agent with `ai.tool()`, configuring a handoff with `ai.handoff()`, and wiring a simple two-agent workflow. These should be copy-paste ready, not pseudocode.
Replace the narrative scenario descriptions in Examples with actual code implementations showing a minimal working multi-agent system (e.g., a 2-agent handoff with routing).
Add explicit validation checkpoints between critical steps—e.g., 'Test agent in isolation before wiring handoffs' with a concrete test command or assertion pattern.
Create the referenced bundle files (implementation.md, errors.md, examples.md) or remove the references and inline the essential content. Currently the skill promises detail that doesn't exist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is moderately efficient but includes unnecessary padding like the Overview section restating the description, verbose scenario descriptions with specific metrics (85% resolution rate, p95 latency) that don't add actionable value, and a Resources section listing things Claude already knows about. The error table is useful but some entries explain obvious concepts. | 2 / 3 |
Actionability | Despite listing 10 steps, the instructions are almost entirely abstract descriptions rather than executable guidance. There are zero code examples—no actual `ai.tool()`, `ai.handoff()`, or agent definition code. Phrases like 'Build routing logic' and 'Wire agents into a workflow' describe rather than instruct. The examples section describes scenarios narratively without any code. | 1 / 3 |
Workflow Clarity | The 10 steps provide a reasonable sequence and step 10 mentions testing, but validation checkpoints are weak—there's no explicit 'validate before proceeding' gate between steps. For a complex multi-agent orchestration involving handoffs and state management, the lack of feedback loops (e.g., verify handoff works before adding routing) and the absence of concrete validation commands caps this at 2. | 2 / 3 |
Progressive Disclosure | The skill references three external files (implementation.md, errors.md, examples.md) which is good structure, but none of these bundle files actually exist. The main SKILL.md also includes substantial inline content (full error table, detailed scenarios) that could be in references, while the actual implementation details that should be inline (code examples) are deferred to a non-existent file. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
3a2d27d
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.