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.
The body is highly actionable with real, executable scripts and a well-structured one-level-deep bundle. Conciseness and workflow_clarity sit at 4 due to minor Purpose/Scripts redundancy and the absence of an explicit error-recovery loop rather than any substantive gap.
Suggestions
Collapse the per-tool descriptions so each tool is described once (e.g., keep detail in the Scripts table and shorten the Purpose list to a one-line role each) to remove the Purpose/Scripts redundancy.
Add an explicit feedback loop after step 4: if phase_gate_scorer returns REDESIGN or NO-GO, state which earlier step (endpoint or sample size) to revisit before re-scoring.
Surface a couple of trigger synonyms in the description (e.g., 'clinical trial', 'protocol synopsis') to lift trigger-term coverage from 4 to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no basic-concept padding, guidelines cited by name), but the three-tool description in 'Purpose' repeats in the 'Scripts' table, a minor over-explanation that could be trimmed — fitting level 4 rather than the lean level 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands are given throughout ('sample_size_estimator.py --design proportions --p1 0.30 --p2 0.45 --dropout 0.15', '--profile {drug|device|biologic|diagnostic|digital-therapeutic}', '--phase {1|2|3|4}') with a 'Quick examples' block covering the common cases, matching the level-5 anchor. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence (Draft synopsis → Select endpoint → Estimate sample size → Score feasibility → Route for sign-off) carries checkpoints ('If >1 primary, plan multiplicity control', 'Trace the effect ... to a published or anchor-based source; inflate for dropout'), but no explicit validate→fix→retry recovery loop, so it lands at level 4 rather than 5; the destructive/batch cap does not apply since outputs are estimates/recommendations. | 4 / 5 |
Progressive Disclosure | SKILL.md is a clean overview with one-level-deep, clearly labeled references (study_design_canon.md, endpoint_and_power.md, trial_operations.md each with a one-line contents description), a scripts table, and an asset template — all verified to exist — matching the level-5 anchor for well-signaled navigation. | 5 / 5 |
Total | 18 / 20 Passed |