skills/by-role/marketing/ab-copy-writer/SKILL.md
Generate A/B copy variants for any piece of marketing copy with a hypothesis per variant. Use when the user says "A/B test this", "write variants", "give me options", "test different angles", "copy variants", "ab copy", "test this headline", "multiple versions", or wants to test copy before publishing. Produces 3-5 variants per copy element with angle, hypothesis, and expected audience response. Reads brand voice and ICP from knowledge/.
npx skillsauth add qa-aman/claude-skills ab-copy-writerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Produces testable copy variants. Every variant has a distinct angle, a hypothesis for why it will outperform, and a predicted audience response. Stops marketers from shipping one version and guessing.
For each variant, pick a distinct angle from this list. Never use the same angle twice in one set:
| Angle | Description | When it wins | |---|---|---| | Outcome-led | Leads with the specific result | When audience is ROI-focused and numbers-driven | | Pain-led | Opens on the problem, not the solution | When audience is in active pain and aware of it | | Speed-led | Emphasizes time-to-value | When audience is impatient or under pressure | | Contrarian | Challenges a common belief | When audience is saturated with standard messaging | | Social proof | Leads with a customer result or name | When audience trusts peers more than vendors | | Curiosity gap | Creates a knowledge gap that demands closing | When audience is information-hungry | | Specificity | Extremely specific number or detail as the hook | When vague claims are common and specifics stand out | | Fear of missing out | What happens if you don't act | When cost of inaction is high and under-communicated | | How-to | Practical, instructional framing | When audience wants actionable takeaways | | Founder/operator voice | Written as a practitioner to a practitioner | When audience distrusts brand voice |
Load context. Read knowledge/brand/voice.md (for tone and style rules) and knowledge/icp/personas.md (for what this audience responds to). If either is missing, ask the user for the relevant context directly.
Check knowledge/learnings.md for any past A/B test results or copy performance data. If a previous test showed "outcome-led beats pain-led for our ICP", factor that in and note it.
Understand the goal. Ask if not provided: "What action should this copy drive? And what's the one thing the audience should feel or believe after reading it?"
Generate variants. For each:
## Variant [A/B/C/D/E]: [Angle name]
**Copy:**
[the actual copy - complete and ready to use]
**Angle**: [name from the angles table]
**Hypothesis**: [1-2 sentences on why this angle should outperform the others for this specific audience]
**Predicted response**: [how the ICP is likely to feel reading this]
**Best for**: [which segment of the ICP or which stage of the funnel this variant suits most]
**Watch for**: [what signal would tell you this variant is winning - clicks, replies, saves, conversions]
Recommend the test setup:
## Recommended test setup
**Test**: [Variant A] vs [Variant B] (start with the two most different angles)
**Why these two**: [1 sentence on why this pairing gives the clearest signal]
**Sample size needed**: [rough guidance - "at least 500 impressions per variant before reading results"]
**How long to run**: [1-2 weeks for LinkedIn organic, 7 days minimum for paid, 3+ sends for email]
**Primary metric**: [clicks / replies / saves / open rate / conversion - pick one]
**How to read results**: [what delta counts as a win: ">10% difference in CTR is signal, <5% is noise"]
Self-check each variant:
knowledge/brand/voice.md style rules (no em dashes, no banned phrases, correct POV)knowledge/icp/personas.md where relevantSave to output/ab-copy/<DD-MM-YYYY>-<copy-element-slug>.md with frontmatter:
---
format: ab-copy
element: [headline|subject-line|hero|cta|hook|ad]
channel: [linkedin|email|landing-page|ad|webinar]
variants: [number]
angles: [list of angles used]
created: DD-MM-YYYY
---
Offer follow-ups:
/retro after the test and log which variant won and why. This gets appended to knowledge/learnings.md so future copy benefits from the result."/content-writer or /linkedin-post to build out the winning variant into a full piece."| Channel | Element | Length | |---|---|---| | LinkedIn | Hook (first 2 lines) | 15-25 words | | LinkedIn | Full post | 80-220 words | | Email | Subject line | 6-10 words | | Email | Preview text | 8-12 words | | Email | Opener (first sentence) | 10-20 words | | Landing page | H1 | 5-10 words | | Landing page | Sub-headline | 15-25 words | | Google ad | Headline | 30 chars max | | Google ad | Description | 90 chars max | | LinkedIn ad | Intro text | 150 chars max | | Webinar | Title | 8-12 words | | CTA button | Text | 2-5 words |
knowledge/learnings.md has already shown underperforms for this ICP without flagging: "Past data shows [angle] underperformed. Including it here for completeness, but Variant X is the higher-confidence bet."development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.