Content
77%Reviews 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 a clear, validated multi-step workflow, but it is over-long and monolithic, explaining statistical concepts Claude already knows and inlining material better suited to separate reference files.
Suggestions
Trim explanations of concepts Claude already knows (e.g., the SRM definition and the power/precision interpretation tables) to reduce token cost without losing actionable thresholds.
Extract the 7-flag statistical-validity catalog and the full output template into referenced files (e.g., references/VALIDITY_FLAGS.md, references/OUTPUT_TEMPLATE.md) and link them from SKILL.md, improving progressive disclosure.
Consolidate the duplicated recommendation/rationale structure between Step 8 and 'Best Practices' to remove redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~527-line body is mostly actionable but padded with explanations Claude already knows (SRM meaning, power-interpretation tables, CI-width buckets), so it is not fully lean; not score 1 because the bulk is concrete guidance rather than concept primer. | 2 / 3 |
Actionability | Concrete, executable guidance throughout: specific MCP tool calls with parameters (e.g., 'Amplitude:query_experiment with metricIds'), explicit numeric thresholds, and copy-paste-ready output/segment table templates. | 3 / 3 |
Workflow Clarity | A clear 8-step sequence with explicit validation checkpoints ('If incomplete, explain what's missing and stop'), a pre-finalization verification checklist, and error-recovery scenarios providing feedback loops. | 3 / 3 |
Progressive Disclosure | It is a monolithic single file with no bundle files present; the inline validity-flag catalog and full output template could be split into referenced files. Not score 1 because sections are reasonably organized and one external skill is signaled. | 2 / 3 |
Total | 10 / 12 Passed |