Content
85%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 SKILL.md body is a model of lean, well-sequenced instructional writing: efficient mode detection, on-demand reference loading, an explicit ethics checkpoint, and recovery paths for non-interactive runs and missing skills. Its one serious defect is bundle integrity — the progressive-disclosure architecture routes almost all substantive content (rules, templates) to files that were never shipped, leaving Steps 3–5 under-specified in practice.
Suggestions
Ship the referenced bundle files: all five rules/*.md and both templates/*.md files cited in 'Required Reading by Mode' are absent — add them so the mode-based loading table and Steps 3–5 ('Follow the loaded rule files', 'run the three-question test', 'Fill the mode's template') actually resolve.
Inline the minimum needed to keep the ethics gate executable — the three test questions from rules/ethics.md belong in SKILL.md (or a shipped file) since Hard Rule 5 says it 'overrides default helpfulness'.
Fix the back-links in references/frameworks.md: its 'Used in' column points to ../rules/*.md files that are also missing — either ship those files or drop the links until they exist.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout: frameworks (COM-B, B=MAP, EAST) are named but never taught, mode detection and required reading are terse tables, and the one example ('✗ "Get people to care about observability." / ✓ "Every engineer opening a PR that adds an API endpoint adds an OTel span to it"') earns its tokens. No section explains concepts Claude already knows, and nothing reads as padding. | 5 / 5 |
Actionability | Guidance is concrete and directive ('Parse the first token of $ARGUMENTS', a numbered four-item context list, 'Every intervention carries its lever, the barrier it targets, the evidence grade'), but Steps 3–5 execute against files whose contents are absent from the bundle — 'run the three-question test in rules/ethics.md' and 'Fill the mode's template' cannot be carried out because rules/ethics.md and both templates are missing. This keeps it below fully-executable; it is well above the pseudocode/vague-hints level of 3. | 4 / 5 |
Workflow Clarity | A clearly sequenced five-step workflow (pin behavior → gather context → run mode → ethics gate → emit) with an explicit validation checkpoint ('Any intervention that fails is dropped from the output and replaced by its honest alternative'), error-recovery paths ('proceed with unknowns and list every assumption'; a missing skill is reported 'skipped (not installed)' and work continues), and a six-item Hard Rules checklist governing the output. This is an advisory, non-destructive skill, so the batch/destructive validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The loading design itself is exemplary — 'Load on demand — never all up-front', a per-mode required-reading table, one-level-deep references with precise section pointers ('§ Evidence grading', '§ Diagnosis only'), and the one shipped bundle file (references/frameworks.md) is well-organized. But 7 of the 8 unique files referenced in the body (all five rules/*.md and both templates/*.md) do not exist in the bundle, and frameworks.md itself links back to missing ../rules/*.md files, so most referenced paths are broken in practice — a majority-scale navigation failure, not the 'minor organization gaps' of 4. | 3 / 5 |
Total | 17 / 20 Passed |