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.md body: a tight four-step workflow with validation checkpoints and a quality checklist, concrete per-audience guidance, and bulk material correctly deferred to two real, one-level-deep bundle files. Nothing teaches what Claude already knows, and nothing needed is left implicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~90-line body instructs at every step with no padding and no explanation of concepts Claude already knows; even the pipeline section exists to carry the actionable rule "If the user's research content is still vague or unstructured, prompt them to clarify objectives and key findings first." It assumes Claude's competence throughout, matching the "lean and efficient; every token earns its place" anchor rather than anchor 4, which would require at least minor over-explanation. | 5 / 5 |
Actionability | As an instruction-only skill the guidance is fully executable: an audience enum with a default ("If unspecified, use `mixed`"), a five-element extraction table (study goal, system/population, main finding, evidence boundary, next action), a concrete output template reference, and quantified-writing principles ("3-fold higher", "in 4 of 6 subtypes"). Per the rubric's code_vs_instruction_skills note, absence of code is not penalized when guidance is this concrete. | 5 / 5 |
Workflow Clarity | Four clearly sequenced steps with a pre-condition check (vague input → prompt user to clarify), an error-recovery path for missing elements ("note it in the output and invite the user to fill in the gap"), and an explicit validation checklist with a feedback loop ("If a check fails, revise before presenting"). This matches the anchor-5 pattern of explicit validation steps plus checklists. | 5 / 5 |
Progressive Disclosure | The body is a clean overview; bulk content is split into assets/output-template.md and references/audience-guide.md, both real files verified as one level deep (no nested references), clearly signaled inline and in a closing References section with per-file descriptions. No unreferenced bundle files and no inlined bulk content — matching the "clear overview with well-signaled one-level-deep references" anchor. | 5 / 5 |
Total | 20 / 20 Passed |