CtrlK
BlogDocsLog inGet started
Tessl Logo

multi-agent-patterns

This skill should be used when designing multi-agent systems that need context isolation, supervisor or swarm coordination, explicit handoffs, parallel execution, or a decision on whether multiple agents are justified.

60

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/multi-agent-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, knowledge-dense design reference with concrete snippets, quantified guidance, and a properly signaled single-level reference file. Its weaknesses are redundancy between Core Concepts and Detailed Topics, absence of an explicit sequenced design workflow with validation checkpoints, and inline detail that could be pushed to the references layer.

Suggestions

Collapse the 'Core Concepts' section: it re-explains context isolation and the three patterns that 'Detailed Topics' covers in full — merge them and delete the duplicate, saving roughly 15% of the body's tokens.

Add an explicit design workflow with checkpoints, e.g. 1. Assess whether context limits justify multiple agents (baseline comparison), 2. Choose pattern from the three based on coordination needs, 3. Define handoff/state-sharing protocol, 4. Validate by testing one failure scenario per failure mode before shipping.

Move the illustrative code blocks (forward_message, swarm handoff, customer routing) into references/frameworks.md alongside the framework implementations, keeping SKILL.md to the design rules and numeric thresholds.

DimensionReasoningScore

Conciseness

The body is mostly efficient with genuinely non-obvious guidance (the ~15x token budget, 3-5 worker cap, telephone-game mitigation), but the 'Core Concepts' section substantially duplicates 'Detailed Topics' (context isolation and the three patterns are each explained twice), and the token-multiplier table's 'Higher than baseline / Much higher than baseline' cells are vague padding. Not anchor 2 — most sections earn their place — but clearly could be tightened, matching anchor 3.

3 / 5

Actionability

Concrete, near-executable guidance abounds: the forward_message tool signature, the swarm handoff snippet, the customer-routing example, and specific numeric thresholds (5+ workers, 3-5 cap, 15x cost, ~50% telephone-game penalty). It falls short of anchor 5 because the code snippets reference undefined objects (agent_b, Agent, transfer_to) and are illustrative rather than copy-paste runnable — anchor 4's 'minor gaps' fit.

4 / 5

Workflow Clarity

Pattern-selection guidance is present ('Choose this pattern when...', per-pattern trade-offs, per-failure mitigations), but there is no sequenced design workflow — no explicit 'assess context limits, then choose pattern, then define handoffs, then validate' chain. Validation appears only as a bare guideline ('Test failure scenarios explicitly') without checkpoints or feedback loops, matching anchor 3's 'sequence present but checkpoints missing or implicit'. Not a destructive/batch skill, so no cap applies; not anchor 4 because checkpoints are largely absent rather than minor-gapped.

3 / 5

Progressive Disclosure

Good structure with a real, existing one-level-deep reference ([Frameworks Reference](./references/frameworks.md)) that is clearly signaled with a 'Read when:' condition, plus well-organized Related skills and External resources with the same signaling. It misses anchor 5 because the ~260-line body still inlines substantial detail (full code examples, the consensus section) that a tighter overview-plus-references split would move out of SKILL.md.

4 / 5

Total

14

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit 'use when' trigger phrasing, concrete multi-agent terminology, and a scoped decision criterion that distinguishes it from adjacent skills. The 'what' side is design-level rather than action-enumerated, and a couple of natural synonyms (orchestrator, hierarchical) are absent, keeping it just below top marks.

DimensionReasoningScore

Specificity

The description lists several concrete capability areas — "context isolation, supervisor or swarm coordination, explicit handoffs, parallel execution, or a decision on whether multiple agents are justified" — which is specific, but it omits coverage of the hierarchical pattern documented in the body, a minor gap. It sits between anchor 3 (1-2 actions) and anchor 5 (comprehensive), closer to 4.

4 / 5

Completeness

The explicit trigger clause "This skill should be used when designing multi-agent systems that need..." clearly answers 'when' with concrete trigger phrases, and 'what' is stated as designing multi-agent systems with those coordination needs. It falls short of anchor 5 because the 'what' is design-scoped and less concretely enumerated than the anchor's action list, but exceeds anchor 4's 'when could be more explicit' — netting a strong 4.

4 / 5

Trigger Term Quality

Natural trigger phrases are present — "multi-agent systems", "supervisor", "swarm", "explicit handoffs", "parallel execution" — which users designing agent systems would plausibly say. A few common synonyms (orchestrator, agent team, agent communication) are missing, matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (multi-agent topology: context isolation, supervisor/swarm coordination, handoffs) and even delimits the boundary case ("a decision on whether multiple agents are justified"), minimizing overlap with adjacent single-agent, tooling, or memory skills. This matches anchor 5: clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
muratcankoylan/Agent-Skills-for-Context-Engineering
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.