Content
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a comprehensive marketing copy handbook than a focused skill instruction file. While it contains genuinely useful copy examples and formulas, it suffers from severe verbosity — inlining extensive reference material (full landing page blueprints, microcopy catalogs, brand voice templates) that should live in separate referenced files. The lack of a clear step-by-step workflow for producing copy, combined with no concrete validation checkpoints, makes it difficult for Claude to follow a structured process.
Suggestions
Move the landing page structure breakdown, headline formulas, CTA templates, microcopy examples, and brand voice template into `docs/skill-guides/marketing-copy.md` (which is already referenced but underutilized), keeping SKILL.md as a concise overview with clear pointers.
Add a concrete numbered workflow: e.g., 1) Gather inputs (objective, audience, constraints), 2) Define/confirm brand voice, 3) Draft copy following AIDA, 4) Validate against anti-AI patterns (with specific checklist items), 5) Review for consistency, 6) Prepare handoff artifacts.
Replace the vague 'rodar mentalmente os 29 padrões' gate with a concrete validation step — either list the top patterns to check inline or reference the specific section of anti-ai-writing.md with clear pass/fail criteria.
Remove explanatory text that describes what each landing page section's 'objective' is (Claude knows what a Hero section does) and instead focus on the specific constraints and quality bars unique to this project/brand.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~250+ lines. It explains concepts Claude already knows (what AIDA is, what a landing page section does, basic microcopy patterns like error messages and 404 pages). The brand voice template, full landing page structure breakdown, and extensive microcopy examples are reference material that bloats the context window significantly. Much of this could be in a referenced guide file. | 1 / 3 |
Actionability | The skill provides concrete examples of headlines, CTAs, microcopy, and copy formulas with good before/after patterns. However, it lacks executable workflows — there's no step-by-step process for actually producing copy (e.g., 'Step 1: gather inputs, Step 2: define voice, Step 3: draft, Step 4: validate against anti-AI patterns'). The guidance is more of a reference catalog than actionable instructions. | 2 / 3 |
Workflow Clarity | There is no clear sequenced workflow for producing copy. The skill lists responsibilities, principles, templates, and handoff items but never defines a step-by-step process with validation checkpoints. The 'Gate' mention of running anti-AI patterns is vague ('rodar mentalmente') with no concrete validation steps. For a skill involving brand-sensitive output, missing feedback loops and review steps is a significant gap. | 1 / 3 |
Progressive Disclosure | The skill references `docs/skill-guides/marketing-copy.md` for 'formulas, templates de copy e exemplos mais longos,' yet the SKILL.md itself already contains extensive formulas, templates, and examples — the very content that should be in that referenced file. The massive inline content (landing page structure, all headline formulas, full microcopy catalog, brand voice template) should be split into referenced files, keeping SKILL.md as a concise overview. | 1 / 3 |
Total | 5 / 12 Passed |