When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," "CTA copy," "value proposition," "tagline," "subheadline," "hero section copy," "above the fold," "this copy is weak," "make this more compelling," or "help me describe my product." Use this whenever someone is working on website text that needs to persuade or convert. For email copy, see emails. For popup copy, see popups. For editing existing copy, see copy-editing. For the offer underneath the copy (bonuses, guarantees, value framing), see offers.
You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action.
Check for product marketing context first:
If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Gather this context (ask if not provided):
If you have to choose between clear and creative, choose clear. Clarity is not just tidier — it converts: clearer positioning and copy is associated with +81% conversions, a 38% shorter sales cycle, 28% lower CAC, and 175% more referrals. When a reader has to decode your line, you've lost them.
For message-market fit tools — the "Now you can" test, the Human Action Model (discomfort → vision → path), the Perception Gap, and the clarity metrics: See references/copy-frameworks.md
Features: What it does. Benefits: What that means for the customer.
Use words your customers use. Mirror voice-of-customer from reviews, interviews, support tickets.
Each section should advance one argument. Build a logical flow down the page.
For thorough line-by-line review, use the copy-editing skill after your draft.
Get to the point. Don't bury the value in qualifications.
❌ Slack lets you share files instantly, from documents to images, directly in your conversations
✅ Need to share a screenshot? Send as many documents, images, and audio files as your heart desires.
Questions engage readers and make them think about their own situation.
Analogies make abstract concepts concrete and memorable.
Puns and wit make copy memorable—but only if it fits the brand and doesn't undermine clarity.
Headline
Example formulas:
For comprehensive headline formulas: See references/copy-frameworks.md
Structure the hero as a transformation — current discomfort → better vision → path to action (the Human Action Model), then run every headline through the "Now you can" test. See references/copy-frameworks.md
For natural transition phrases: See references/natural-transitions.md
Subheadline
Primary CTA
| Section | Purpose |
|---|---|
| Social Proof | Build credibility (logos, stats, testimonials) |
| Problem/Pain | Show you understand their situation |
| Solution/Benefits | Connect to outcomes (3-5 key benefits) |
| How It Works | Reduce perceived complexity (3-4 steps) |
| Objection Handling | FAQ, comparisons, guarantees |
| Final CTA | Recap value, repeat CTA, risk reversal |
For detailed section types and page templates: See references/copy-frameworks.md
Weak CTAs (avoid):
Strong CTAs (use):
Formula: [Action Verb] + [What They Get] + [Qualifier if needed]
Examples:
Before writing, establish:
Formality level:
Brand personality:
Maintain consistency, but adjust intensity:
When writing copy, provide:
Organized by section:
For key elements, explain:
For headlines and CTAs, provide 2-3 options: