Content
77%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.
An excellent router skill — unambiguous routing via symptom table, decision tree, and per-framework signposting, with genuinely valuable non-obvious content in the Anti-Rationalization and Critical Patterns sections. Its main weakness is redundancy: the routing map is restated five times across sections, inflating token cost by roughly a third.
Suggestions
Consolidate the routing map: keep the Quick Reference table and the numbered Decision Tree list, and cut the dot graph, the 'External Routes' prose (its rows duplicate the table), and most of the 'Example Invocations' section, which restates existing table mappings.
Remove or make concrete the orphan 'Cursor Subagent Routing' section — 'Delegate to the appropriate Cursor subagent when this router calls for a specialized auditor' names no specific agent or command and adds no actionable information beyond the later 'Automated Scanning' section.
Where the body cites local paths like `skills/spritekit.md` and `skills/game-input.md`, either ship those files in the skill bundle or state where they resolve, so the router's references are verifiable at load time.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The same routing map is presented five times: the 24-row "Quick Reference" table, the "External Routes" prose bullets, the dot "Decision Tree" graph, the 15-item numbered decision list, and 14 "Example Invocations" — roughly a third of the file is duplication. The content itself is dense and non-obvious (not concept padding), keeping it above anchor 2, but it could clearly be tightened to one or two routing presentations. | 3 / 5 |
Actionability | Routing guidance is highly specific and executable ("Physics bitmask issues (default 0xFFFFFFFF, missing contactTestBitMask...)" → `skills/spritekit-diag.md`; "Half-screen collider shapes for movement and camera (never small circles)"), and the instruction-only nature is fine for a router skill. Minor gaps: the orphan "Cursor Subagent Routing" section says to "Delegate to the appropriate Cursor subagent" with no concrete instruction, and the cited `skills/*.md` paths cannot be resolved within this bundle. | 4 / 5 |
Workflow Clarity | This is a single-action router skill: route a symptom or task to one reference. That action is unambiguous — the decision tree, symptom table, and numbered list all map each input to exactly one target, and no destructive or batch operations exist that would require validation checkpoints. | 5 / 5 |
Progressive Disclosure | The body is a model router: a concise overview with well-signaled, one-level-deep references ("See `skills/spritekit-diag.md`", "See axiom-graphics (skills/realitykit.md)") organized by symptom, framework, and task, matching the top anchor's structure. Note: no bundle files (references/, scripts/, assets/, skills/) were provided alongside SKILL.md, so the referenced paths could not be verified to exist in this bundle. | 5 / 5 |
Total | 17 / 20 Passed |