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.
The body is a dense, directive six-step workflow where every sentence earns its place, backed by explicit validation, feedback loops, and sign-off gates, plus a checkable Definition of Done. Detail is correctly pushed one level deep into references/format.md, which exists and matches its advertised contents. This is a model example of an instruction-oriented skill body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every sentence instructs ("The repo's convention wins", "'Fast' or 'intuitive' is a goal at best, never a criterion", "Zero silent inventions") and the brief rationale clauses serve enforcement, not concept explanation Claude already knows. Nothing trimmable was found, matching the lean anchor rather than the minor-trims anchor at 4. | 5 / 5 |
Actionability | Fully actionable instruction-only guidance: concrete drafting rules ("The overview's first sentence says what the feature does for its user", "new criteria take fresh IDs, removed ones leave holes"), a runnable command ("Run `<plugin root>/scripts/prose-lint.py` on the spec file"), templates delegated to references/format.md at the exact step they are needed, and a checkable Definition of Done. Per the rubric's code-vs-instruction note, absence of code is not penalized. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with explicit validation (step 5: "Every goal is covered by at least one criterion… fix every finding"), a validate-fix loop enforced by the DoD ("passes prose-lint.py with no findings"), hard gates ("Then wait"; "the user signs off before anything downstream builds on it"), and a Definition of Done checklist — matching the anchor requiring explicit validation, feedback, and checklists. | 5 / 5 |
Progressive Disclosure | The body is a well-signaled overview: a references table giving file, read-timing ("step 1, when the repo has no spec convention"), and contents, with the timing restated in the workflow ("Read `../../assets/writing.md` first"). references/format.md was verified to exist, be one level deep, and hold exactly what the table claims; the plugin-root-relative paths are explicitly defined ("`<plugin root>` is two directories above it") and resolve outside this bundle copy by design. | 5 / 5 |
Total | 20 / 20 Passed |