Content
86%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: executable seeded code, a decision tree, a mistakes checklist, and a sequenced workflow, with detail correctly offloaded to real one-level-deep reference and script files.
Suggestions
Add an explicit 'validate the schedule' checkpoint in the Workflow (e.g., call arm_balance(sched) and confirm balance before archiving) so batch generation has a visible validation step rather than one shown only in the code example.
Tighten the pseudoreplication worked example in 'The mistakes that ruin studies' to the load-bearing rule (replicate at the level the treatment is randomized) and defer the worked mice/cells illustration to references/design_types.md.
Consider moving the four 'Key references' citations into a reference file to keep SKILL.md as a pure overview, though this is a minor conciseness point.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, information-rich content that assumes Claude's competence (Fisher's principles stated tersely) with a few spots of mild over-explanation (e.g., the pseudoreplication worked example) that could be trimmed, fitting the 'efficient; minor instances' anchor rather than the fully lean anchor. | 4 / 5 |
Actionability | Copy-paste-ready, seeded, executable code covering the common cases (block/stratified/cluster randomization; full/fractional/Plackett-Burman/CCD designs) returning real-unit layouts, plus an inline arm_balance sanity check, matching the fully-executable anchor. | 5 / 5 |
Workflow Clarity | An explicit 8-step sequenced workflow with auditability (seed/archive) and a cross-reference for sample size; validation is present (arm_balance, seed archiving) but is implicit rather than called out as an explicit checkpoint in the workflow steps, so it sits at clear-sequence-with-minor-gaps rather than the explicit-validation anchor. | 4 / 5 |
Progressive Disclosure | Clear overview with well-signaled one-level-deep references to references/ and scripts/ files that all exist on disk, a dedicated Resources section repeating them, and content appropriately split, matching the clear-overview-with-one-level-references anchor. | 5 / 5 |
Total | 18 / 20 Passed |