Content
77%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 instruction skill with a clear step sequence, explicit validation checkpoints, and clean one-level-deep reference disclosure. The main weakness is redundancy: several constraint lists and the cohort-family taxonomy are restated across multiple sections and could be consolidated.
Suggestions
Consolidate the repeated 'should not' constraints into a single Hard Rules section, and reference it from 'Core Function' and 'What This Skill Should Not Do' instead of restating them.
Merge 'Supported Cohort Study Families' into 'Cohort Design Selection Logic' to avoid restating the same cohort taxonomy twice.
Add one short filled example (a mini worked protocol skeleton) to ground the abstract A–L output structure for Claude.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient procedural guidance with little generic background, but the same constraints recur across sections (negative rules appear in 'Core Function', 'What This Skill Should Not Do', and 'Hard Rules'; the cohort-family list is restated in both 'Supported Cohort Study Families' and 'Cohort Design Selection Logic') and could be consolidated. Not a 4 because the redundancy exceeds minor trimming; not a 2 because content is domain procedure, not padding of concepts Claude already knows. | 3 / 5 |
Actionability | Concrete, executable guidance throughout — explicit 11-step sequence, per-step reference-module invocation, and a mandatory A–L output structure specifying what each section must contain. Not a 5 because no filled example protocol is provided to anchor the abstract structure. | 4 / 5 |
Workflow Clarity | Clear sequenced 11-step execution path with explicit validation checkpoints ('If any output section is generated without using its corresponding reference module, the output should be treated as incomplete'), an input-validation/redirect gate, and a clarification rule — giving explicit feedback loops. | 5 / 5 |
Progressive Disclosure | Well-organized overview that maps each of the 12 one-level-deep reference files (all verified present in references/) to specific output sections, with clear navigation and bulk detail pushed into the bundle. | 5 / 5 |
Total | 17 / 20 Passed |