Content
92%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, highly actionable instruction skill: a coherent workflow from context-gathering through diagnosis to drafting and a validated pre-delivery self-check, with excellent progressive disclosure to three well-anchored reference files. The only weakness is a few sections (Best Practices, Voice and Tone) that restate fundamentals Claude already knows and could be trimmed or folded into references.
Suggestions
Trim or merge the 'Best Practices' section (Be Direct, Use Analogies When Helpful, Pepper in Humor) into the references — these restate fundamentals the model already knows, while the adjacent Slack ❌/✅ example is the only part earning inline tokens.
Compress the 'Voice and Tone' section (formality levels, brand personality questions) into the 'Before Writing' context checklist so it reads as input to gather rather than explanation of concepts Claude knows.
Fold the 'Benefits Over Features' / 'One Idea Per Section' one-liners into copy-frameworks.md alongside the other principles, keeping SKILL.md focused on the workflow and rules the model cannot derive itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core protocol content is dense and skill-specific — the diagnosis table, taste-reading rules, decompose-and-lock, three-question gate, AI-tells rules, and the claims-decline protocol are all non-obvious and compressed. However, the "Best Practices" section ("Be Direct," "Use Analogies When Helpful," "Pepper in Humor") and "Voice and Tone" restate copywriting fundamentals Claude already knows, which is more than the "minor instances" of the 5 anchor but far from the padding of the 3 anchor's unnecessary explanation — the bulk of every token-heavy section earns its place. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: a three-situation diagnosis table with a required one-line evidence statement, named drafting units with candidate counts, a three-question gate with numeric pass thresholds ("Three passes, keep it. Two, sharpen the weak one"), banned patterns with rewrite instructions ("State a real absence once, near the CTA"), CTA formulas with examples, a flagging convention ([NEED: ...]), and a specified output format with alternatives. This matches the fully-actionable top anchor. | 5 / 5 |
Workflow Clarity | The sequence is clear and ordered: check product-marketing context → gather four context areas → diagnose (state it in one line with evidence) → decompose and lock units → gate every line → ration the punch → leave-it-alone test → pre-delivery self-check (search banned patterns, read sentences over 20 words, read aloud) → output format. Explicit validation checkpoints exist at drafting (three-question gate) and delivery (self-check, leave-it-alone test), with error-recovery paths ("rewrite it from the facts or flag what's missing"), matching the top anchor with explicit validation and feedback loops. | 5 / 5 |
Progressive Disclosure | The body keeps the core workflow inline and offloads bulk detail to three real, one-level-deep reference files, each clearly signaled with inline markdown links and verified section anchors (references/ai-tells.md#the-self-check, #build-a-writer; references/copy-frameworks.md#clarity--message-market-fit; references/natural-transitions.md). Cross-links between sibling references are lateral pointers, not chained nesting, so navigation is easy and content is appropriately split — matching the top anchor. | 5 / 5 |
Total | 19 / 20 Passed |