Multi-agent routing, channel bindings, and tool policies
53
36%
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 ./src/skills/bundled/routing/SKILL.mdQuality
Discovery
7%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description is extremely weak, consisting only of abstract technical jargon without explaining what the skill actually does or when it should be used. It fails to provide actionable information for Claude to select this skill appropriately and would be nearly impossible for users to trigger with natural language.
Suggestions
Add concrete action verbs describing what the skill does (e.g., 'Configures routing rules between agents', 'Defines access policies for tools', 'Manages communication channels between AI agents').
Include a 'Use when...' clause with natural trigger terms users might say (e.g., 'Use when setting up agent communication, defining which tools agents can access, or routing requests between multiple AI agents').
Replace or supplement technical jargon with user-friendly language that explains the practical purpose (e.g., 'Controls how multiple AI agents work together and what tools each can use').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description uses abstract technical jargon ('multi-agent routing', 'channel bindings', 'tool policies') without explaining what concrete actions the skill performs. No verbs describe actual capabilities. | 1 / 3 |
Completeness | The description only vaguely hints at 'what' through abstract concepts and completely lacks any 'when' guidance. There is no 'Use when...' clause or equivalent trigger guidance. | 1 / 3 |
Trigger Term Quality | The terms used are highly technical jargon that users would rarely say naturally. Terms like 'channel bindings' and 'tool policies' are not natural user language for requesting help. | 1 / 3 |
Distinctiveness Conflict Risk | The technical terms are somewhat specific to a particular domain (multi-agent systems), which provides some distinctiveness, but the vagueness could still cause confusion with other agent-related or policy-related skills. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid API reference with excellent actionability - the code examples are complete, executable, and well-structured. However, it's somewhat verbose for a skill file (could be split into overview + detailed reference), and lacks validation/error handling guidance that would be important when configuring routing and tool policies in production.
Suggestions
Add error handling examples showing what happens when routing fails or an invalid agent/tool is specified
Split into SKILL.md (overview + quick start) and ROUTING_API.md (detailed reference) to improve progressive disclosure
Remove or condense the 'Best Practices' section - these are generic guidelines Claude can infer from the API design
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient with good code examples, but includes some unnecessary sections like 'Best Practices' with generic advice Claude already knows, and the built-in agents table duplicates information from the code example above it. | 2 / 3 |
Actionability | Provides fully executable TypeScript code examples that are copy-paste ready, concrete chat commands with clear syntax, and specific configuration patterns. All examples are complete and runnable. | 3 / 3 |
Workflow Clarity | The routing rules section explains the decision sequence clearly, but there are no validation checkpoints or error handling examples. For operations like adding agents or updating tool policies, there's no guidance on verifying success or handling failures. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections and tables, but it's a monolithic document that could benefit from splitting detailed API reference into separate files. No references to external documentation for advanced topics like workspace isolation or custom routing logic. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
2a8c94e
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.