Content
71%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 instructional skill: a clear 9-step workflow mapped to a concrete 10-section output format, with detailed rules correctly externalized to ten real, purpose-mapped reference files and explicit validation gates for output completeness. The main weakness is redundancy — 'Core Function,' 'Hard Rules,' 'What This Skill Should Not Do,' and 'Quality Standard' substantially restate one another and the Execution steps — which inflates token cost without adding guidance value. The absence of an inline worked example (input → refined objective) also leaves the common case implicit.
Suggestions
Collapse 'What This Skill Should Not Do' and 'Quality Standard' into 'Core Function' and the relevant Execution steps — these sections restate the same rules (no full protocol, no fake precision, confirmatory/exploratory separation) verbatim, and cutting them would remove roughly a third of the body without losing any guidance.
Add one inline worked example (a vague input objective like 'explore the mechanism of immune escape in colorectal cancer' plus its refined plain-language / protocol-ready / downstream-ready outputs) so the common case is demonstrated without opening the reference files.
Deduplicate Hard Rules 1-10 against the Execution steps by keeping them as a short checklist of true constraints (e.g., literature-integrity rules 11-13) and removing those that merely restate Steps 1-9.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Per-line the body is efficient — no padding explaining concepts Claude already knows — but structurally it restates itself across sections: 'Core Function' items 1-10 duplicate the Execution steps 1-9, 'What This Skill Should Not Do' re-lists the not-rules already given in 'Core Function' ("write a full protocol," "force confirmatory wording," fake precision), and 'Quality Standard' restates the Mandatory Output Structure's purpose, and Hard Rules overlap both. This matches anchor 3 ('mostly efficient but could be tightened') rather than anchor 2, since every line is operational directive rather than unnecessary explanation, but roughly a third of the ~290 lines is redundancy that could be cut without loss. | 3 / 5 |
Actionability | As an instruction-only skill it gives concrete, specific guidance: Step 3 lists the exact elements to audit ("target population or system, exposure / biomarker / intervention, outcome or readout, comparison, time horizon, context"), Step 6 mandates three named output versions, and Sections A-J define a concrete deliverable. It falls short of anchor 5 only because there is no inline worked example (vague input objective → refined output) covering the common cases — that detail is deferred to references — so it sits at 'mostly executable guidance with minor gaps.' | 4 / 5 |
Workflow Clarity | The 9-step Execution sequence is clearly ordered and explicitly mapped to output sections A-J via the Reference Module Integration table, and there are validation gates: "If any output section is generated without using its corresponding reference module, the output should be treated as incomplete," plus Step 8's measurability/executability assessment and Hard Rule 14's completeness test. It is not anchor 5 because there is no explicit error-recovery feedback loop (e.g., what to do when Step 8 finds the objective still non-executable — revision is only implied), which keeps it at 'clear sequence with most checkpoints present.' | 4 / 5 |
Progressive Disclosure | All 10 referenced files exist in references/ and each is individually signaled with a one-level-deep, purpose-bound mapping: "references/objective-type-taxonomy.md → use when classifying the dominant objective type in Section B," with every other module tied to a specific section or task. Content is appropriately split — the operational detail lives in the reference modules while SKILL.md holds the workflow — matching the anchor 5 pattern of a clear overview with well-signaled single-hop references and easy navigation. | 5 / 5 |
Total | 16 / 20 Passed |