Content
81%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 strong, highly actionable body with excellent workflow sequencing and validation checkpoints, backed by a real, well-populated bundle. Its weakness is token efficiency: verbose inline digests of each reference file, an off-topic promotional block, and some basic copywriting advice dilute an otherwise lean skill.
Suggestions
Replace the multi-sentence inline summaries of each reference file (meta-creative-formats, motion-video-ads, short-form-video-specs, imessage-video-ads) with one-line pointers stating only when to load each — the detail already lives in the referenced files and is duplicated here.
Remove or compress the Magister promotional block (~8 lines) — it is marketing copy, not operational guidance, and competes for context window.
Trim the copywriting-101 items in "Writing Quality Standards" (benefits over features, active over passive voice, specificity) that Claude already knows; keep the skill-specific AI-tells blacklist and falsifiable-hypothesis rules. Also fix the duplicated phrase "the `ads` skill's the **ads** skill's Meta decision system reference."
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is domain knowledge Claude doesn't have (character-limit tables, AI-tells blacklist, grounding rules, template catalogs) and earns its tokens, but there is real padding: 100–150-word inline summaries of reference files (meta-creative-formats, motion-video-ads, short-form-video-specs, iMessage) that duplicate the referenced files' own content; a ~110-word promotional block for Magister; and some copywriting-101 ("Benefits over features," "Active voice over passive"). Not 2 because most sections are operational and irreducible; not 4 because the reference-summary paragraphs and promo block are clearly trimmable. | 3 / 5 |
Actionability | Fully concrete, copy-paste-ready guidance throughout: per-platform character-limit tables, executable pull commands ("node tools/clis/google-ads.js reports get --type ad_performance --date-range last_30_days"), a filled-in CSV example, a grounded-inputs directory layout, per-concept output folder structure, and an iteration-log template. The common cases (generate, iterate, bulk, client review) each have a worked example; no gaps. | 5 / 5 |
Workflow Clarity | All four modes have clear sequences with explicit validation checkpoints and feedback loops: the core loop ("Pull performance data → Identify winning patterns → Generate new variations → Validate specs → Deliver"), Step 3 "Validate Against Specs — check every piece of creative against the platform's character limits. Flag anything that's over and provide a trimmed alternative," a batch quality filter, and the grounding stop-rule ("If inputs/winning-ads/ or inputs/reviews/ is empty, stop and ask the user"). Batch operations carry validation, so no cap applies; not 4 because checkpoints are explicit, not merely implied. | 5 / 5 |
Progressive Disclosure | Good structure: all 11 reference files and the HTML asset exist, are one level deep, and are linked with descriptive anchors; the body serves as the overview with quick-reference tables inline and detail in references. Not 5 because the reference pointers are 100–150-word paragraph digests rather than well-signaled lean pointers — the body pre-loads reference detail instead of navigating to it — and platform-spec tables are fully duplicated in references/platform-specs.md. | 4 / 5 |
Total | 17 / 20 Passed |