Content
67%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 well-structured, information-dense skill body with concrete commands, useful anti-patterns, and a clear workflow. Its main defect is that every external artifact it points to (two reference files and one script) is missing from the bundle, leaving dangling references and an unusable tooling section.
Suggestions
Add the actual 'references/metrics-frameworks.md', 'references/dashboard-templates.md', and 'scripts/metrics_calculator.py' files to the bundle, or remove the 'See:' list and Tooling section so no path in the body dangles.
Consolidate the Workflow steps 2-4 detail with the duplicated 'KPI Guidance By Stage', 'Dashboard Design Principles', and 'Cohort Analysis Method' sections into one treatment each to cut repeated content.
Add an explicit validation checkpoint to the workflow (e.g., confirm the events CSV matches the user_id/cohort_date/activity_date schema before invoking metrics_calculator.py, and sanity-check the retention matrix for anomalies).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and specific with no padding or explanation of concepts Claude already knows (e.g., 'Compare retention curves, not single-point snapshots', 'Sharp early drop, low plateau: onboarding mismatch'). However, Workflow steps 2-4 duplicate the later 'KPI Guidance By Stage', 'Dashboard Design Principles', and 'Cohort Analysis Method' sections, which could be consolidated. | 4 / 5 |
Actionability | The Tooling section gives copy-paste-ready commands ('python3 scripts/metrics_calculator.py retention events.csv --format json') plus concrete CSV schemas covering the common cases, and the anti-pattern table pairs each problem with a specific fix. The score is not 5 because the documented script 'scripts/metrics_calculator.py' does not exist in the bundle, so the commands dead-end when followed. | 4 / 5 |
Workflow Clarity | The 5-step Workflow (select framework, define stage-appropriate KPIs, design dashboard layers, run cohort/retention analysis, interpret and act) is clearly sequenced with interpretive checkpoints ('Distinguish signal from noise using period-over-period context'). It is not 5 because there are no explicit validation steps or feedback loops (e.g., verifying the CSV matches the expected schema before running the calculator); the destructive/batch cap does not apply since all operations are read-only analysis. | 4 / 5 |
Progressive Disclosure | Although sections are well organized, the body's 'See:' references to 'references/metrics-frameworks.md' and 'references/dashboard-templates.md' and the entire Tooling section for 'scripts/metrics_calculator.py' point to files that do not exist in the bundle (no references/, scripts/, or assets/ directories are present). Scored against the actual bundle structure, the navigation paths are broken and would mislead the reader, which is worse than the anchor-3 case of merely unclear signaling; it is above anchor 1 because the body itself is well sectioned and the references are at least plainly listed. | 2 / 5 |
Total | 14 / 20 Passed |