CtrlK
BlogDocsLog inGet started
Tessl Logo

plano-agent-orchestration

Improve multi-agent orchestration in Plano. Use for agent registration, agent listener wiring, and capability-focused agent descriptions for accurate routing.

59

Quality

68%

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/plano-agent-orchestration/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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.

An exceptionally lean, well-structured body that respects the token budget completely, but its guidance stops one level short of executable: no example description rewrites, no sample test prompts, and no error-recovery loop after validation. The "Apply These Rules" section also references rules that do not exist in the bundle.

Suggestions

Add a short before/after example of a capability-focused agent description (and 1-2 sample routing test prompts) to make steps 3-5 executable rather than directional.

Turn step 5 into a feedback loop: run the test prompts, and if routing picks the wrong agent, revise the description and re-test — this addresses the missing validation checkpoints.

Resolve the "Apply These Rules" section: either include the referenced rule files in the bundle and link them by path, or inline their content so nothing dangles.

DimensionReasoningScore

Conciseness

The body is ~30 lean lines with zero padding — no explanation of what multi-agent orchestration is, no filler, and every section (When To Use, Apply These Rules, Execution Checklist) earns its place. It matches anchor 5 exactly; there is nothing to trim and no over-explanation that would justify a 4.

5 / 5

Actionability

Some guidance is concrete and checkable — "Verify each agent exists in both `agents` and `listeners[].agents`" names exact config locations — but the rest stays abstract: "Rewrite descriptions to be capability-focused and non-overlapping" and "Provide test prompts" give no examples of a good vs. bad description or a sample test prompt. Not 4 — key executable details (file paths, example rewrites, sample prompts) are missing; not 2 — the checklist steps are specific instructions, not high-level hints.

3 / 5

Workflow Clarity

The five-step checklist gives a coherent sequence, and step 5 "Provide test prompts to validate routing outcomes" names a checkpoint, but validation is only "provide prompts" — there is no run-validate-fix-retry feedback loop and no guidance on what to do when routing tests fail. Not 4 — checkpoints are weak/implicit with no error-recovery path; not 2 — the sequence is complete and well-defined rather than full of gaps.

3 / 5

Progressive Disclosure

For a sub-50-line skill the single-file organization is appropriate and the sections are clearly labeled, which per the rubric's simple-skill guideline would merit a 5. It drops to 4 because "Apply These Rules" lists `agent-orchestration` and `agent-descriptions` with no resolvable files in the bundle — no references/ or scripts/ directories exist — so those references are neither clearly signaled nor verifiable. Not 3 — content is appropriately inline and navigation is easy; not 5 — the dangling rule references are unresolved.

4 / 5

Total

15

/

20

Passed

Description

67%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 solid description with an explicit "Use for..." trigger clause and several concrete, domain-specific capabilities. Its weaknesses are a vague opening verb ("Improve..."), trigger terms that lean technical rather than natural, and missing common synonyms a user would say when routing misbehaves.

Suggestions

Replace or augment the generic opening "Improve multi-agent orchestration in Plano" with the concrete operations the skill performs (verify agent/listener registration, rewrite descriptions, validate routing).

Add natural trigger phrasings and synonyms users would say — e.g. "agents not routing correctly", "set up sub-agents", "listeners.agents mismatch" — to improve trigger_term_quality.

Include the config surface or file names users would mention (e.g. the agents config or listeners config) so the description is more distinguishable and more searchable.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "agent registration", "agent listener wiring", and "capability-focused agent descriptions" — which goes beyond naming the domain. It falls short of anchor 5 because the opening "Improve multi-agent orchestration in Plano" is generic and coverage of the skill's actual sub-tasks (fallback agents, test prompts) is incomplete, but it is well above anchor 3's 1-2 actions.

4 / 5

Completeness

Both parts are present: "Improve multi-agent orchestration in Plano" answers what, and "Use for agent registration, agent listener wiring, and capability-focused agent descriptions for accurate routing" is an explicit when-clause with concrete triggers. Not 5 — the "what" ("Improve...") is vague about the actual operations; not 3 — the when is explicit, not merely implied.

4 / 5

Trigger Term Quality

Terms like "agent registration", "agent listener wiring", and "accurate routing" are relevant and reasonably natural for this domain, but coverage misses common variations users would actually say (e.g. "set up agents", "routing is wrong", "agent config", file/config names). Not 4 — several natural phrasings are missing; not 2 — more than one or two relevant keywords are present and they are domain-specific rather than generic.

3 / 5

Distinctiveness Conflict Risk

The pairing of "Plano", "agent listener wiring", and "listeners[].agents"-adjacent terminology carves a clear niche that would rarely fire for unrelated skills. Not 5 — "agent descriptions" and "routing" could overlap with generic agent-prompting or routing skills; not 3 — the platform name and listener-specific wiring make it mostly distinct.

4 / 5

Total

15

/

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
katanemo/plano
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.