Content
93%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 skill body: lean, template-driven, and fully executable, with clearly sequenced record/query workflows and a real pre-write review checkpoint. The only notable flaw is that the recording workflow doesn't handle a missing or malformed docs/adr/README.md index when it goes to update it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~80-line body is lean and assumes Claude's competence: it never explains what an ADR is or why decisions get recorded, gives a two-line framing then goes straight into a compact template, terse numbered workflows, and a short quality-standards list. Every section earns its place; nothing matches the over-explanation in the anchor-4 example. | 5 / 5 |
Actionability | Fully executable throughout: a complete copy-paste markdown template with every mandatory section, the exact command `Glob docs/adr/[0-9]*.md`, the exact file-naming rule `docs/adr/NNNN-kebab-title.md`, a concrete index table format `| ADR | Title | Status | Date |`, and specific supersession semantics (update old Status, add back-reference). This matches the anchor-5 fully-executable standard. | 5 / 5 |
Workflow Clarity | Both workflows are clearly sequenced, with an explicit checkpoint ("Present the draft — show it to the user for review before writing any file") and fallback branches ("If not, offer to start the ADR directory"; "If no ADR matches, suggest recording one now"). The gap keeping it below anchor 5: the recording workflow's step 7 ("Update the index") assumes docs/adr/README.md already exists and its table format is known, with no instruction for creating or verifying it — a minor validation gap characteristic of anchor 4. No destructive/batch cap applies since writes are additive new files. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and none are needed: all content (when-to-record, template, workflows, quality standards) is core operational material that correctly lives inline, organized under clear headers. There are no buried or nested references and no monolithic wall of content that should be split out, so a self-contained, well-sectioned file is the appropriate structure. | 5 / 5 |
Total | 19 / 20 Passed |