Content
85%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.
A well-structured, highly actionable skill body: an ordered 7-step workflow with a mandatory pre-output validation checkpoint, concrete tables, templates, and numeric rules, and exemplary one-level-deep reference splitting. The only real weakness is redundancy — several rules (DESeq2/limma, never-fabricate, gap-traceability) are repeated across the Steps, Hard Rules, and the anti-section, inflating token cost without adding information.
Suggestions
State each rule once: the DESeq2/limma rule, the never-fabricate rule, and the gap-traceability rule each appear 2–3 times across Step 3.5/Step 7, Hard Rules, and 'What This Skill Should Not Do' — keep the step-level statement and cut the verbatim Hard Rule repetitions.
Merge 'What This Skill Should Not Do' into the out-of-scope and Hard Rules sections (or cut it to the 2–3 items not already covered), since nearly every bullet restates an existing rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — no padding explaining concepts Claude already knows — but several rules are stated two or three times: the DESeq2/limma rule appears in Step 7 ("count data → DESeq2 preferred") and again verbatim in Hard Rule 11; "Never fabricate" appears in Step 3.5, Hard Rule 8, and "What This Skill Should Not Do"; the "What This Skill Should Not Do" section largely restates the out-of-scope list and hard rules. Not 4 because the duplication is more than minor trims; not 2 because there is no conceptual over-explanation. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is fully actionable: a pattern-selection table with concrete "When to Use" conditions, numeric retrieval minimums ("2–4 gap-background / disease-context references", "1–2 core method / design-support references"), a copy-paste redirect template with [restatement] placeholders, concrete method mappings, and a fully specified A–J output skeleton with per-section content definitions. | 5 / 5 |
Workflow Clarity | "Execution — 7 Steps (always run in order)" gives an explicit sequence, Step 4 is a mandatory pre-output validation checklist ("Does the proposed study directly answer the stated gap, or did it drift into a generic workflow?"), and there is an explicit feedback loop ("If any inconsistency is found, revise the plan before outputting") — matching the anchor-5 'explicit validation steps; feedback loops; checklists' example. | 5 / 5 |
Progressive Disclosure | The body is an overview that splits detail across nine reference files, each signaled at its point of use with a "→ ...: [references/...](references/...)" pointer (e.g., "→ Detailed pattern logic: references/gap-to-design-patterns.md"). All nine referenced files exist in references/ and none contain nested references, so navigation is one level deep — matching the anchor-5 structure. | 5 / 5 |
Total | 18 / 20 Passed |