Content
88%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 high-quality, well-structured skill body that balances executable recipes with a clear workflow and appropriately offloads detail to genuine bundle files. It is slightly more discursive than strictly necessary in the overview and pitfalls sections, but every section earns its place.
Suggestions
Tighten the Overview and 'Common pitfalls' sections — the conceptual framing about under/overpowered studies restates knowledge Claude already has and could be cut to save tokens.
The 'Adjustments people forget' section mixes guidance with formulas; moving the formula derivations (DEFF, n_enroll) into the references and keeping only the commands inline would improve conciseness.
Consider a one-line 'Verify before reporting' checkpoint in the Workflow that points to the Monte Carlo CI / sensitivity range as the acceptance criterion, making the existing feedback loop explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and assumes Claude's competence (skips explaining what a t-test is), but the Overview and several prose passages around effect-size philosophy and pitfalls are somewhat discursive and could be trimmed without losing actionability. | 4 / 5 |
Actionability | Provides copy-paste-ready, executable code for both closed-form (`scripts/power.py`) and simulation (`scripts/simulate_power.py`) paths, with concrete worked examples covering the common cases and an explicit reporting template. | 5 / 5 |
Workflow Clarity | The numbered Workflow section sequences every step from stating the design through sensitivity analysis and adjustments, and the simulation recipe includes explicit validation feedback (report Monte Carlo CI, re-search for target n), giving clear checkpoints and error-recovery guidance. | 5 / 5 |
Progressive Disclosure | SKILL.md is a concise overview with one-level-deep, clearly signaled references to real files (`references/closed_form_recipes.md`, `references/simulation_based_power.md`, `references/effect_sizes.md`) and scripts (`scripts/power.py`, `scripts/simulate_power.py`), all of which exist in the bundle; navigation is easy. | 5 / 5 |
Total | 19 / 20 Passed |