CtrlK
BlogDocsLog inGet started
Tessl Logo

orchestrating-multi-agent-systems

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

Quality

62%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

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.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
Reviewed

Table of Contents

Is this your skill?

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.