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, concrete, and well-sequenced. It assumes Claude's competence, delegates all detail to the repo's own RFC process and template documents, includes a validation checklist, and defines an explicit feedback loop for blocking unknowns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~47-line body is lean: it never explains concepts Claude already knows, and every line gives repo-specific instruction (paths, numbering, front-matter fields, section-level heuristics, boundaries like "Do not update published docs just because an RFC was drafted"). It matches the 5 anchor's 'every token earns its place'; the slight echo between step 8 and the Validation section is a checklist elaboration, not padding that would justify the 4 anchor. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: exact paths (rfc/README.md, rfc/0000-template/README.md, rfc/NNNN-short-title/README.md), exact rules (choose next NNNN, state: draft, hyphenated folder title, GitHub-handle fallback for author), and a conditional lint check. Per the rubric's scoring note, an instruction-only skill needs no code when guidance is this specific — it fully matches the 'copy-paste ready' spirit of the 5 anchor. | 5 / 5 |
Workflow Clarity | The 8-step sequence is clearly ordered (read process docs → read template → pick number → create folder → fill front matter → draft sections → preserve open questions → re-check), with a dedicated Validation checklist before handoff and an explicit feedback loop ("If a missing decision blocks a coherent RFC, ask the user for that decision"). This matches the 5 anchor's explicit validation, error-recovery loop, and checklist; the operation is not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and none are needed: the body is under 50 lines and well-organized into Workflow, Writing Standards, and Validation sections, while delegating all template/process detail one level deep to rfc/README.md and rfc/0000-template/README.md instead of inlining it. Per the rubric's guideline for short, self-contained skills, this matches the 5 anchor. | 5 / 5 |
Total | 20 / 20 Passed |