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.
The body is a well-engineered thin index: lean, highly actionable process guidance with excellent mode routing and workflow checkpoints. Its critical weakness is that the progressive-disclosure design is not backed by the bundle — all thirteen rule files and all four templates referenced by the routing tables are missing, so the skill cannot actually load the content it defers to.
Suggestions
Ship the referenced bundle files: all 13 rules/*.md and all 4 templates/*.md paths cited in the Area Routing and Required Reading tables are absent from the bundle, so every routing decision leads to a file that cannot be loaded. Either include them or inline the essential rules per area.
Remove the 'Required Reading by Area' table (or collapse it to just the templates and references rows): it re-lists the identical thirteen area-to-file mappings already given in 'Area Routing', spending ~20 lines on pure duplication.
Add one compact inline exemplar per mode (e.g., a single sample review finding with What/Rule/Fix, or a filled-in system-prompt skeleton fragment) so the skill stays actionable even when rule files have not yet been loaded.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean index that assumes competence — no explanations of what RAG or prompt caching are, one-liner anti-patterns, and date-sensitive material properly delegated to references/recent-changes.md. It is not a 5 because the 'Area Routing' table and the 'Required Reading by Area' table duplicate the same thirteen file mappings (~20 redundant lines). | 4 / 5 |
Actionability | Concrete, executable process guidance throughout: explicit parsing rules ("$0 == \"review\""), a stated-mode output template, a findings format (What/Rule/Fix with path:line and ≤10-line snippets), a one-message question list for design mode, and a template mapping. It falls short of fully copy-paste-ready because all substantive per-area rules are deferred to rule files rather than exemplified inline. | 4 / 5 |
Workflow Clarity | Three modes each get unambiguous detection rules, an explicit checkpoint ('State the detected mode... before continuing'), numbered steps, a consent gate ('Do not edit the file in review mode unless the user asks for fixes'), prioritized findings ('Top 3 fixes'), and a closing Definition of Done checklist — clear sequence with explicit validation, fitting the top anchor. No destructive or batch operations are performed, so the workflow-clarity cap does not apply. | 5 / 5 |
Progressive Disclosure | The written design is exemplary — a self-described 'thin index' with clearly signaled, one-level-deep references and per-area 'load when' guidance — but scored against the actual bundle, 17 of the 19 referenced paths are dangling: none of the rules/*.md or templates/*.md files exist; only references/primary-sources.md and references/recent-changes.md are present. Navigation to the core detailed content is therefore broken, which is more than the 'minor organization gaps' of the 4-anchor, though SKILL.md itself is a proper overview rather than a monolith, keeping it above the 2-anchor. | 3 / 5 |
Total | 16 / 20 Passed |