Content
61%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 SKILL.md body is well-organized and actionable for common marketing tasks, with concrete rules and situation-to-model mappings. However, its single external reference (references/mental-models-catalog.md) does not exist in the bundle, so the promised 70+ model catalog is unreachable, and the workflows lack explicit sequencing and validation checkpoints.
Suggestions
Add the missing references/mental-models-catalog.md file (or remove the reference) — the body's core claim ('The full catalog lives in...') points to a path that does not exist in the bundle, breaking the Reference mode and all model lookups.
Give each mode a short explicit step sequence with a validation checkpoint (e.g., Diagnose: identify target behavior → audit asset against relevant principles → verify each finding against the catalog → output tagged fixes), and make the 'Self-verify' items in the Communication section a concrete procedure rather than a bare list.
Trim the one-line definitions of universally known biases (Loss Aversion, Social Proof, Reciprocity, Anchoring) and keep only the marketing-application guidance, which is the part Claude does not already know.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly application-focused (tables mapping situations to models, concrete fixes like "Show customer count, testimonials, logos"), but it spends tokens on one-line definitions of biases Claude already knows ("Loss Aversion — People feel losses 2x more than gains", "Social Proof — People follow others"). This matches anchor 4 (efficient with minor over-explanation that could be trimmed) rather than 5; it is above anchor 3 because the padding is limited to the model definitions and the rest earns its place. | 4 / 5 |
Actionability | For an instruction-only skill, the guidance is largely concrete: specific before/after CTA wording ("'Submit' or 'Get started' vs 'Start my free trial""), quantified rules ("Under $100: show % discount. Over $100: show $ discount", "Limit to 3 tiers"), and a situation-to-models quick reference covering common cases. It falls short of anchor 5 because the Communication section is underspecified ("Self-verify: source attribution, assumption audit, confidence scoring" gives no concrete procedure) and the 'Explain [principle]' mode depends on a catalog file that is not present in the bundle, leaving gaps in executable guidance. | 4 / 5 |
Workflow Clarity | The three modes (Diagnose, Apply, Reference) and the five Task-Specific Questions provide a rough sequence, but there is no guidance on how to proceed through a mode (e.g., what steps a 'Diagnose' analysis follows), and validation is only vaguely present via "Self-verify: source attribution, assumption audit, confidence scoring" with no checkpoints or feedback loops. This matches anchor 3 (steps listed, checkpoints missing or implicit); it is above anchor 2 because the modes and questions do form a coherent rough sequence. | 3 / 5 |
Progressive Disclosure | The body signals a single one-level-deep reference ("The full catalog lives in [references/mental-models-catalog.md]... Load it when you need to look up specific models or browse the full list"), but the bundle contains no references/ directory — the referenced file does not exist, so the skill's core detailed content is inaccessible. Judged against the actual bundle structure, this is a broken primary reference, fitting anchor 2 (minimal effective structure; the content that should be reachable is missing) rather than anchor 3, where references are at least present and real. | 2 / 5 |
Total | 13 / 20 Passed |