Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced skill body with concrete commands, templates, and explicit decision/NEEDS_INPUT checkpoints. Its main weaknesses are redundancy between the Skill Contract and the Instructions, and several referenced files that resolve outside the bundle and are not actually present.
Suggestions
Collapse the overlap between the "Skill Contract" block (Reads/Writes/Done when/Primary next skill) and the "Instructions" steps — merge or cross-reference instead of restating, to remove roughly 150 tokens of repetition.
Vendor the needed excerpts from the absent parent-repo files (skill-contract.md, measurement-protocol.md, roas-benchmark.md, CONNECTORS.md, SECURITY.md) into local references/, or explicitly label them as external plugin-root dependencies, so the in-skill links do not dead-end.
The closing "Next Best Skill" section restates the contract's "Primary next skill" line — keep one canonical location and link to it to avoid drift.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and substantive, but the "Skill Contract" (Reads/Writes/Done when/Primary next skill) overlaps heavily with the 8-step "Instructions" and the closing "Next Best Skill" restates the contract's primary-next-skill line, so content could be tightened by ~150 tokens. Not a 1: it does not pad with explanations of basic concepts Claude already knows; statistical methods are named, not over-explained. Not a 3: the contract/instructions redundancy is genuine avoidable repetition. | 2 / 3 |
Actionability | Gives a copy-paste-ready keyless command (`python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/experiment.py" proportion --control ...` with `continuous`/`samplesize` subcommands), a fill-in hypothesis template ("Because [observation], we believe [one change] will [raise primary metric] by [X%]..."), named statistical methods with conditions, and a concrete provenance-labeling scheme. Not a 2: guidance is specific and executable, with a documented manual-formula fallback in the reference, not pseudocode. | 3 / 3 |
Workflow Clarity | Eight numbered steps run Pick mode → Hypothesis → Variant matrix → Metrics → Sizing/power → Significance read → Decision ownership → Provenance, with explicit checkpoints: NEEDS_INPUT stop in step 1, the UNDECIDED decision-owner gate in step 7, the "do not retrofit thresholds" multiplicity gate in step 6, and the enumerated "Done when" completion criteria. Not a 2: checkpoints are explicit, not implicit; this is a decision-gated workflow rather than a batch/destructive op needing fix-retry loops. | 3 / 3 |
Progressive Disclosure | The body is a well-sectioned overview and the one bundled detail file (references/test-design-guide.md, which exists) is correctly used for the matrix template, sizing table, and formulas — good one-level-deep split. However, 5 of the 6 referenced paths (skill-contract.md, CONNECTORS.md, SECURITY.md, measurement-protocol.md, roas-benchmark.md) sit outside the skill bundle and are not present, so navigation dead-ends for a reader of the bundle. Not a 1: it is not monolithic, references are clearly signaled and only one level deep, not nested 2+ levels. Not a 3: the dangling parent-repo references break the 'easy navigation' anchor when scored against the actual bundle structure. | 2 / 3 |
Total | 10 / 12 Passed |