| name | marketing-copy |
| description | Write, review, and critique marketing copy using proven copywriting frameworks. Use when the user asks to write or generate sales copy, headlines, bullet points, email teasers, email sequences, sales letters, sales pages, landing page copy, social media ad copy (Facebook, Instagram, LinkedIn), product descriptions, Amazon listings, or webinar registration copy. Also use when the user asks to review, critique, audit, score, or improve existing copy. Frameworks include customer avatar definition (F.R.E.D.), headline formulas, the ultimate bullet formula (feature + benefit + meaning), PAS / benefit / before-after-bridge sales formulas, email subject-line patterns, offer building and risk reversal, stealth closes, hooks and angles, and swipe file methodology. Produces multiple variations by default. |
| license | MIT |
Marketing Copy
Frameworks adapted from Jim Edwards' Copywriting Secrets (31 secrets). Principles are presented as universal craft; consult the reference files for detailed templates and examples.
Modes
| Mode | When to use | Behavior |
|---|
| Quick (default) | User wants copy now | Infer avatar and formula from context; produce immediately |
| Guided | User says "help me write" or context is thin | Ask F.R.E.D. questions first, then produce |
If critical information is missing (product, audience, desired action), ask before generating regardless of mode.
Writing copy workflow
1. Gather context
Determine from the request or by asking:
- Product/service: What are we selling?
- Audience: Who is the ideal customer? (If unclear, build a F.R.E.D. avatar, see below)
- Desired action: What should the reader do? (Click, buy, sign up, register, reply)
- Medium: Where will this copy appear? (Sales page, email, ad, social post, product listing)
- Angle/hook: What is the main promise or curiosity trigger?
2. Build the avatar (when needed)
If the audience is undefined, load references/fred-avatar.md and run through the F.R.E.D. framework:
- Fears: What keeps them up at night?
- Real desires: What do they actually want (not what they say they want)?
- End goals: What is the ultimate outcome they are chasing?
- Dreams: What does success look like for them?
Also capture: demographics, where they hang out online, words and phrases they use, their objections and skepticism.
3. Apply the framework
Select the copy type and load the matching reference:
For psychology and emotional triggers, load psychology-and-emotion.md.
For proof elements (testimonials, credibility), load proof-and-closes.md.
4. Generate variations
For headlines, bullets, subject lines, and hooks: produce 3 to 5 variations using different angles or formulas. Label each with the technique used.
For long-form copy (sales letters, emails): produce one complete version, then offer alternative openings or headlines.
5. Polish
Apply the editing checklist from swipe-and-polish.md:
- Cut filler words and hedging language
- Tighten paragraphs (1 to 3 sentences for email and ads)
- Strengthen verbs; replace passive with active voice
- Check reading level (aim for grade 6 to 8)
- Read aloud to catch awkward phrasing
Reviewing copy workflow
Checklist audit (quick)
Load review-checklist.md and score the copy on a 0 to 2 scale across each dimension:
- Headline: Does it grab attention and create curiosity?
- F.R.E.D. alignment: Does it speak to the avatar's fears, desires, and language?
- Bullets: Are they benefit-driven (not just features)?
- Emotion: Does it connect emotionally before asking for action?
- Call to action: Is it clear, specific, and singular?
- Proof: Are there credibility elements?
- Risk reversal: Is there a guarantee or objection handling?
- Clarity: Could a 12-year-old understand the offer?
Output a scored table with specific fix recommendations for anything scoring 0 or 1.
Deep critique (thorough)
Go line by line through weak sections. For each problem:
- Quote the problematic text
- Identify the principle violated
- Provide a rewritten alternative
- Explain why the rewrite works
Offer to apply all fixes and produce a revised version.
Key principles (always apply)
- People buy on emotion, justify with logic. Lead with feeling, support with facts.
- It is all about them, never about you. The reader cares about their problems, not your product features.
- The headline is the most important piece of copy. If the headline fails, nothing else gets read. Spend disproportionate time here.
- Features tell, benefits sell. Every feature must answer "which means..." to the customer.
- A confused mind says no. Clarity beats cleverness. One message, one offer, one call to action.
- Risk reversal increases conversion. Remove the buyer's risk with guarantees, trials, or bonuses.
- Great copy is assembled, not written. Use proven formulas and patterns (swipe files) rather than inventing from scratch.
Reference library
| File | When to load |
|---|
| fred-avatar.md | Building a customer avatar; audience is unclear |
| headlines-and-bullets.md | Writing or evaluating headlines, bullet points |
| sales-formulas.md | Writing sales letters, sales pages, long-form copy |
| email-and-ads.md | Writing email teasers, ad copy, social posts |
| offers-and-desire.md | Building offers, bonus stacks, risk reversal |
| psychology-and-emotion.md | Understanding why people buy, emotional triggers, positioning |
| proof-and-closes.md | Adding testimonials, stealth closes, ethical persuasion |
| swipe-and-polish.md | Research methods, swipe files, editing and refinement |
| review-checklist.md | Auditing or scoring existing copy |
| all-secrets-index.md | Quick lookup of any of the 31 copywriting secrets |
