Content
96%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 exemplary instruction-only skill body: a tightly sequenced audit workflow with concrete look-for lists, hard verification rules before reporting, and a fully specified output format demonstrated by a worked example. The only structural note is that it is a self-contained ~93-line process spec with no bundle files, which is fine but sits just outside the simple-skill case for progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean throughout — short sentences, no explanations of concepts Claude already knows, and it assumes competence (e.g., it names "check-then-write races" and "O(n^2) on big input" as things to look for without teaching them). The one worked example (the billing/close_day.py finding) earns its tokens by demonstrating the required output format; this fits the 'every token earns its place' anchor rather than the 'minor instances of over-explanation' anchor below. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact look-for lists ("injection, weak randomness, secrets in code", "a query per item"), a hard verification rule ("Before calling code unused, grep the whole tree"), a complete four-part finding template with file:line citation format (`billing/close_day.py:L40-52`), an executable one-line fix (`datetime.now(ZoneInfo("Europe/Berlin")).date()`), and exact output strings ("What this repo does:", "Verdict:", "Not checked:"). Per the scoring notes, absence of code blocks is not penalized when the guidance is this actionable; it exceeds the 'mostly executable, minor gaps' anchor. | 5 / 5 |
Workflow Clarity | A clear four-phase sequence (Map first → Look for → Check before you report → Output) with an explicit pre-report validation gate: "Every finding needs a concrete case... No case, no finding" and the grep-before-dead-code check with its remediation (drop the finding if references exist). The destructive/batch cap does not apply because the skill is read-only ("One-shot report, changes no code"); the validation checklist and error-recovery rule (discard unverified findings) match the top anchor. | 5 / 5 |
Progressive Disclosure | The ~93-line body is well organized into four numbered sections and is self-contained with no references, which is appropriate since none are needed; nothing is inlined that clearly belongs in a separate file. It scores 4 rather than 5 because the under-50-line simple-skill exception does not strictly apply and the document is a full process spec rather than an overview with well-signaled references; it is above the 'some structure but could be better organized' anchor. | 4 / 5 |
Total | 19 / 20 Passed |