Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A disciplined, information-dense router skill: a clear classify-then-route workflow, a concrete routing matrix, and quality gates that act as checklists, with lean externalized detail. The recurring weaknesses are duplicated anti-atmosphere guidance across two sections, no worked routing example, and a References section that lists many external files without per-file navigation cues.
Suggestions
State the anti-atmosphere rule once (either Overview or Quality Gates) and cross-reference it from the other section, trimming the duplicated 'broad brush strokes, wispy ribbons, bokeh/orbs, cinematic wallpaper' passages.
Add one short worked routing example (request -> classified job/data shape -> chosen route -> Response Contract output) to make the workflow and response contract concrete.
Annotate the References section with a per-file when-to-read cue (like the conditional reads in the Routing Matrix) instead of listing 17 external foundation/template files in flat category bullets.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and lean — it names Vega-Lite, deck.gl, Structurizr, ScrollTrigger, etc. without explaining them, and every section carries routing or gating instructions rather than padding. It falls just below anchor 5 because the anti-atmosphere guidance ('broad translucent brush strokes, wispy ribbons, bokeh/orbs, cinematic wallpaper, stock-photo haze, or decorative gradients' in the Overview and 'broad brush strokes, wispy ribbons, bokeh/orbs, one-hue drama, cinematic wallpaper' in Quality Gates) is stated twice and could be trimmed to one place. | 4 / 5 |
Actionability | As an instruction-only skill it gives concrete, executable guidance: a named routing matrix with specific technologies, conditional reference reads ('When routing is unclear, read ./references/route-by-problem.md'), and a Response Contract specifying exactly what to state for recommendations vs implementation. It matches anchor 4 ('mostly executable guidance... with minor gaps') rather than 5 because there is no worked example of a routing decision or a filled-out Response Contract output. | 4 / 5 |
Workflow Clarity | The Router Workflow is a clearly sequenced 9-step list with explicit fallbacks ('When routing is unclear, read...'; 'When stack choice is unclear, read...'), and Quality Gates plus the Response Contract function as checkpoints. It is not 5 because there is no explicit validation step confirming the chosen route or deliverable against the Quality Gates before responding — checkpoints are listed but not wired into the workflow as verify-then-proceed loops. | 4 / 5 |
Progressive Disclosure | Good structure: the body is a true overview, the three local references (route-by-problem.md, default-stack-selection.md, prompt-routing-examples.md — all present in the bundle) are one level deep and clearly signaled with when-to-read conditions, and deeper material is appropriately external. It falls short of anchor 5 because the final References section is a categorized but flat dump of ~17 external ../../ foundation/template files with no per-file when-to-read guidance, and those external paths cannot be verified within the skill's own bundle. | 4 / 5 |
Total | 16 / 20 Passed |