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 well-built instruction-only skill body: a clearly sequenced audit/verify/explain workflow with an evidence hierarchy, explicit failure handling, and concrete phrasing rules, all reasonably token-efficient. Weaknesses are modest: no worked example of a filled-in answer, no feedback loop when verification contradicts the audit, and slight redundancy between the two explanation sections.
Suggestions
Add one filled-in example of the answer template using realistic specifics (file paths, a test name, a log line) so the output shape is copy-paste concrete rather than only sketched.
Merge "Explanation Standards" into "3. Explain Simply" (or move the translation table next to it) to remove the duplicated explanation-style rules and cut length.
Add a short feedback rule for when verification contradicts the audit (e.g. "If evidence contradicts the claim, go back to step 1 and re-audit the change before explaining").
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: it never explains concepts Claude already knows (no "what a diff is" padding), uses tight bullets, and every rule is about behavior. Minor trimming is possible — e.g. "Do not say 'everything works'" in Explanation Standards restates the caveat rule from "Keep important caveats visible" and "what was and was not checked" in Verify. It is above the 3 anchor (only isolated tightening needed) but short of the 5 anchor's every-token-earns-its-place lean. | 4 / 5 |
Actionability | Concrete, specific guidance throughout: a 5-level ordered evidence hierarchy, a copy-paste markdown answer template, exact phrasing rules ("Say 'measured faster' only when before/after measurements exist"), a term-translation table, and fact-vs-judgment examples. Per the rubric's scoring note, the absence of code is not penalized for an instruction-only skill. It falls short of 5 because there is no worked example of a filled-in answer (a real What changed/Why it matters/How I verified it block with actual paths and test names) covering a common case. | 4 / 5 |
Workflow Clarity | A clearly sequenced three-step workflow (Audit → Verify → Explain) with an explicit audit checklist ("obvious bugs or regressions, missing edge cases, stale assumptions, unverified claims"), an ordered verification ladder, and explicit failure/partial-verification handling ("When verification fails, report the blocker... say exactly what was and was not checked"). It is not the 5 anchor because there is no feedback loop between steps — no guidance to re-audit or escalate when verification contradicts the audit's expectations — leaving minor validation gaps. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are referenced, so all content lives appropriately in SKILL.md with clear section headers and easy navigation. It is above the 3 anchor (structure is clean, nothing is buried) but not the 5 anchor: the body runs ~100 lines and the "Explanation Standards" section substantially overlaps "Explain Simply" (both govern explanation style), so the split into two sections and the length are minor organization gaps. | 4 / 5 |
Total | 16 / 20 Passed |