Content
100%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: lean, imperative, and fully concrete. It defines a clear four-phase workflow with an explicit verification gate before reporting, and specifies the output format down to exact line templates with a worked example. No bundle files are needed and none are referenced.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is instruction — scope rules ("Review what the user names: uncommitted or staged changes, a branch, a PR link, or files"), priorities ("Order of importance: correct, safe, holds under load, tested, fast, lean"), and output format. No concepts Claude already knows are explained; brief rationale lines like "This is a report the user asked for, so give it in full" each change behavior, so every token earns its place. | 5 / 5 |
Actionability | Fully executable guidance for an instruction-only skill: exact output openers ("Start with `What this change does:`"), a worked four-part finding example with a real fix (`datetime.now(ZoneInfo("Europe/Berlin")).date()`), exact verdict formats ("Verdict: Ship."), the lean summary line, the not-checked line, and the empty case ("Looks good. Ship."). The output is copy-paste ready and covers the common cases. | 5 / 5 |
Workflow Clarity | Clear four-phase sequence (Understand first → Look for → Check before you report → Output) with an explicit validation gate before reporting: "Every finding needs a concrete case ... No case, no finding" and "Re-read the lines and confirm: the caller exists, the value can really be empty, the code really is unused." This is a read-only review skill, so the destructive/batch validation cap does not apply; the checklist matches the 5 anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), and the ~90-line body is a cohesive single-task workflow in four numbered sections with nothing that clearly belongs in a separate file. Well-organized and easy to navigate; splitting it would hurt rather than help, so the structure matches the top anchor. | 5 / 5 |
Total | 20 / 20 Passed |