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: tight, operational check definitions with severity tiers, an explicit safety gate for running lint scripts, prompt-injection hygiene, and a concrete report format with coverage disclosure. No padding, no inferred-only steps, and structure appropriate to a self-contained skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: "A report, not a repair. Read `./CLAUDE.md`, then scan" and one-line check definitions like "broken link — a link whose target file does not exist" with zero concept explanations. Every line carries non-obvious policy (e.g., "Compare resolved commits, not tag spellings"), matching the 'every token earns its place' anchor; the level-4 anchor's 'minor instances of over-explanation' cannot be identified. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully operational: exact paths (wiki/index.md, log.md, raw/), machine-checkable check definitions ("overclaimed support — `support: solid` on a page whose `sources:` lists one"), an explicit safe-script gate, and a concrete report format ("Group by severity, numbered, each with the file path and the one-line fix"). Per the rubric's code-vs-instruction note, the absence of code is not penalized; the level-4 'minor gaps' anchor fits worse than fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The sequence is explicit and ordered (read CLAUDE.md → script-first inspection with skip-and-report on unsafe behavior → independent inventory → checks → report), with validation checkpoints throughout: "a successful exit is not proof that every check ran", "State which files and checks were covered and which were skipped. Never present a partial scan as a clean bill of health", and error paths for a missing index or unsafe script. The read-only lint has coverage verification standing in appropriately for fix-retry loops, matching the level-5 anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed: the skill is self-contained with clear sections (Script first, Scan, Checks, Report, Rules) and easy navigation, and the checks catalog is needed on every invocation so inlining it is the correct placement. The level-4 anchor requires 'minor organization gaps', which are absent; content is appropriately (not) split for a skill of this size. | 5 / 5 |
Total | 20 / 20 Passed |