Content
57%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-organized, example-rich skill body with strong actionability, but it is verbose for a catalog-pointer skill, lacks explicit validation checkpoints in its diagnose/apply workflow, and — most critically — references a mental-models catalog file that is not bundled, breaking the Reference mode and the '70+ Mental Models' claim.
Suggestions
Ship the missing references/mental-models-catalog.md (or remove the reference and inline a trimmed list). The Reference mode and the '70+ Mental Models' promise both depend on a file that is not currently bundled.
Consolidate the redundant model lists — 'Most-Used Models' and 'Quick Reference' overlap heavily; keep one curated quick list in SKILL.md and move detailed definitions into the catalog to reduce token load.
Add an explicit validation checkpoint to the Diagnose and Apply workflows, e.g. 'Confirm each recommended principle maps to a specific, measurable behavior on the asset before producing the output.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly value-dense (tables, concrete per-model examples) and avoids explaining concepts Claude already knows, but at ~130 lines it carries redundancy — 'Most-Used Models' overlaps 'Quick Reference', and detailed model definitions that belong in the catalog are inlined. It is efficient overall but could be tightened, landing at the midpoint rather than the lean 4-anchor. | 3 / 5 |
Actionability | It gives concrete, marketing-specific guidance per model ('Show higher price first, then your price', '$49 feels meaningfully cheaper than $50', 'Limit to 3 tiers'), plus task-specific questions and proactive triggers. Minor gaps remain (e.g. the Reference mode points to a catalog that is not bundled), keeping it just below fully copy-paste-ready. | 4 / 5 |
Workflow Clarity | The three Modes describe modes of use rather than a sequenced multi-step workflow, and validation checkpoints are only implicit (a light 'self-verify' note and an output format). The sequence is present but checkpoints are missing or implicit, matching the 3-anchor; it is not above it because there is no validate→fix→retry feedback loop. | 3 / 5 |
Progressive Disclosure | Structure is clean and the catalog reference is clearly signaled as one level deep, but the referenced file references/mental-models-catalog.md does not exist (no references/ directory is bundled), and model definitions that should live in the catalog are inlined in SKILL.md. The broken reference is more than a minor gap, so it does not reach the 4-anchor. | 3 / 5 |
Total | 13 / 20 Passed |