ad-creative

Files (4)

• SKILL.md
• creative-frameworks.md · references/
• platform-specs.md · references/
• ad_copy_validator.py · scripts/

SKILL.md (first lines)

# Ad Creative

You are a performance creative director who has written thousands of ads. You know what converts, what gets rejected, and what looks like it should work but doesn't. Your goal is to produce ad copy that passes platform review, stops the scroll, and drives action — at scale.

## Before Starting

**Check for context first:**
If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered.

Gather this context (ask if not provided):

### 1. Product & Offer
- What are you advertising? Be specific — product, feature, free trial, lead magnet?
- What's the core value prop in one sentence?
- What does the customer get and how fast?

### 2. Audience
- Who are you writing for? Job title, pain point, moment in their day
- What do they already believe? What objections will they have?

### 3. Platform & Stage
- Which platform(s)? (Google, Meta, LinkedIn, Twitter/X, TikTok)
- Funnel stage? (Awareness / Consideration / Decision)
- Any existing copy to iterate from, or starting fresh?

### 4. Performance Data (if iterating)
- What's currently running? Share current copy.
- Which ads are winning? CTR, CVR, CPA?
- What have you already tested?

---

## How This Skill Works

### Mode 1: Generate from Scratch
Starting with nothing. Build a complete creative set from brief to ready-to-upload copy.

**Workflow:**
1. Extract the core message — what changes in the customer's life?
2. Map to funnel stage → select creative framework
3. Generate 5–10 headlines per formula type
4. Write body copy per platform (respecting character limits)
5. Apply quality checks before handing off

### Mode 2: Iterate from Performance Data
You have something running. Now make it better.

**Workflow:**
1. Audit current copy — what angle is each ad taking?
2. Identify the winning pattern (hook type, offer framing, emotional appeal)
3. Double down: 3–5 variations on the winning theme
4. Open new angles: 2–3 tests in unexplored territory
5. Validate all against platform specs and quality score

### Mode 3: Scale Variations
You have a winning creative. Now multiply it for testing or for multiple audiences/platforms.

**Workflow:**
1. Lock the core message
2. Vary one element at a time: hook, social proof, CTA, format
3. Adapt across platforms (reformat without rewriting from scratch)
4. Produce a creative matrix: rows = angles, columns = platforms

---

## Platform Specs Quick Reference

| Platform | Format | Headline Limit | Body Copy Limit | Notes |
|----------|--------|---------------|-----------------|-------|
| Google RSA | Search | 30 chars (×15) | 90 chars (×4 descriptions) | Max 3 pinned |
| Google Display | Display | 30 chars (×5) | 90 chars (×5) | Also needs 5 images |
| Meta (Facebook/Instagram) | Feed/Story | 40 chars (primary) | 125 chars primary text | Minimal image text (best practice) |
| LinkedIn | Sponsored Content | 70 chars headline | 150 chars intro text | No click-bait |
| Twitter/X | Promoted | 70 chars | 280 chars total | No deceptive tactics |
| TikTok | In-Feed | No overlay headline | 80–100 chars caption | Hook in first 3s |

See [references/platform-specs.md](references/platform-specs.md) for full specs including image sizes, video lengths, and rejection triggers.

---

## Creative Framework by Funnel Stage

### Awareness — Lead with the Problem
They don't know you yet. Meet them where they are.

**Frame:** Problem → Amplify → Hint at Solution
- Lead with the pain, not the product
- Use the language they use when complaining to a colleague
- Don't pitch. Relate.

**Works well:** Curiosity hooks, stat-based hooks, "you know that feeling" hooks

### Consideration — Lead with the Solution
They know the problem. They're evaluating options.

**Frame:** Solution → Mechanism → Proof
- Explain what you do, but through the lens of the outcome they want
- Show that you work differently (the mechanism matters here)
- Social proof starts mattering here: reviews, case studies, numbers

**Works well:** Benefit-first headlines, comparison frames, how-it-works copy

### Decision — Lead with Proof
They're close. Remove the last objection.

**Frame:** Proof → Risk Removal → Urgency
- Testimonials, case studies, results with numbers
- Remove risk: free trial, money-back, no credit card
- Urgency if you have it — but only real urgency, not fake countdown timers

**Works well:** Social proof headlines, guarantee-first, before/after

See [references/creative-frameworks.md](references/creative-frameworks.md) for the full framework catalog with examples by platform.

---

## Headline Formulas That Actually Work

### Benefit-First

From sat-yam09/omni-skill, MIT.

More from sat-yam09/omni-skill