Content
75%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 instruction-only skill: lean, specific, and sequenced with input-validation and post-draft guideline checks, supported by real one-level-deep reference files. It falls just short of top marks on conciseness (duplicated guideline mapping), actionability (no sample output prose), workflow closure (no explicit fix-after-check step), and disclosure placement (end-loaded references).
Suggestions
Deduplicate the guideline mapping: keep it in one place (either Step 1's 'Applicable reporting guideline' line or the Quick Reference table, with the other linking to references/reporting_guidelines.md), and drop the quoted '> "Method Writing produces..."' line.
Add one short worked example in Step 3 — a single model Methods paragraph showing past tense, first-use abbreviation definition, and placeholder usage — so the required prose register is demonstrable rather than only described.
Close the feedback loop in Step 4: after 'Identify any required item that is missing or incomplete', add an explicit instruction to revise the draft to address fixable gaps and re-check before Step 5 delivery, and inline-link references/reporting_guidelines.md at that point of use.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and additive — per-study-type required inputs, a subsection-by-subsection output structure, and hard rules with exact placeholder syntax — with no explaining of concepts Claude already knows. Two minor trims keep it below anchor 5: the guideline-to-study-type mapping appears twice (Step 1 'Applicable reporting guideline: CONSORT (RCT), STROBE (observational)...' and again in the Quick Reference table), and the quoted line '> "Method Writing produces Methods section text..."' adds little. Well above anchor 3, which requires unnecessary explanation. | 4 / 5 |
Actionability | Highly concrete for an instruction-only skill: the eight IMRAD subsections each specify their required contents, the hard rule gives exact placeholder syntax '[AUTHOR TO SPECIFY: randomization method]', and Step 5 gives a verbatim deliverable format ('CONSORT items covered: [list]. Items not addressed (need from author): [list]'). Below anchor 5 only because there is no worked example of the target output prose (e.g., one model Methods paragraph demonstrating register, tense, and abbreviation style) — a minor gap per the instruction-only guidance in the rubric's scoring notes. | 4 / 5 |
Workflow Clarity | Five clearly sequenced steps with real checkpoints: 'If the study type is unclear, ask one focused question before proceeding', 'If critical items are missing, ask for them before writing', and a post-draft Step 4 guideline check. Below anchor 5 because the feedback loop is not fully closed: Step 4 says to 'Identify any required item that is missing or incomplete' and flag items, but never explicitly instructs revising the draft to close those gaps before delivery — a minor validation gap versus the anchor-5 'fix and re-validate' pattern. Not a destructive/batch operation, so the cap-at-3 rule does not apply. | 4 / 5 |
Progressive Disclosure | Appropriate split: the ~120-line SKILL.md keeps workflow and rules inline while three substantial detail files (imrad_structure.md, reporting_guidelines.md, writing_principles.md — 615/748/786 lines, verified to exist with no nested references) carry the deep material, one level deep and clearly labeled. Two minor gaps versus anchor 5: the Quick Reference table duplicates content that belongs in reporting_guidelines.md, and the references are grouped in a terminal list rather than linked at point of use (e.g., Step 4 does not point to reporting_guidelines.md when it runs the guideline check). | 4 / 5 |
Total | 16 / 20 Passed |