Content
70%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 a well-sequenced, validated workflow, but it leans long and keeps material (a query cookbook and archetype table) inline that would fit a reference file. Tightening repeated warnings and splitting the cookbook would lift conciseness and progressive disclosure.
Suggestions
Deduplicate the [MCP]-prefix/Title-Case guidance into a single 'Known pitfalls' note and reference it from Prerequisites and Phase 0 rather than restating it.
Move the Query Cookbook (and optionally the error-archetype table) into a references/ file and link to it from SKILL.md so the overview stays lean.
Name the concrete Amplitude chart/render tools instead of the abstract 'ad-hoc chart query + render tools' phrasing so the charting step is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of basic-concept padding, but the [MCP]-prefix/Title-Case warning recurs in Prerequisites, Phase 0, and Known pitfalls, and rationale-hygiene guidance repeats; the dense ~275-line body could be tightened. | 3 / 5 |
Actionability | Executable JSON query definitions with specific groupByLimit values and exact property names, plus a fix-archetype table and a report template; minor gaps where chart-rendering and Amplitude tool names stay abstract ('use the ad-hoc chart query + render tools'). | 4 / 5 |
Workflow Clarity | A clear Phase 0→5 sequence with explicit validation checkpoints — Phase 0 warns on low volume, Phase 5 mandates re-verifying a headline number a second way and recomputing every percentage, cutting or labeling unverifiable figures. | 5 / 5 |
Progressive Disclosure | Well-organized into named phases, but no bundle files exist and nothing is offloaded to references; the large query cookbook and archetype table are inlined where a one-level-deep reference file would aid navigation. | 3 / 5 |
Total | 15 / 20 Passed |