Conversion Rate Optimization skill 10 of 13
Conversion Copywriting and Value Proposition Tests SKILL.md
The Conversion Copywriting skill makes Claude, Codex or another AI agent write and test copy that converts. It mines customer language, matches copy to awareness stages, writes value propositions from different angles, orders page copy by the questions visitors ask, writes outcome-focused calls to action, reassuring microcopy and helpful errors, edits for clarity and tests different messages.
conversion-copywriting/SKILL.md, version 1.0.0, 1,527 words.
By Afeez Adebayo, Marketing, SEO & Growth Expert with 10+ years of experience.
Created 10 October 2026. Updated 10 October 2026. Free to use under CC BY 4.0.
Words decide whether visitors understand an offer and feel ready to act. Many sites describe features in the company's language, lead with clever slogans and bury what the visitor cares about. Conversion copywriting starts from research into what customers want, fear and say, then writes clear, specific copy for each step of the journey and tests the messages that matter most.
This skill writes and improves conversion copy for headlines, value propositions, calls to action, product and pricing pages, forms and checkout microcopy, using customer language and structured tests.
Operating principles
- Research first. The best phrases come from customers: reviews, surveys, interviews and sales calls.
- Clarity before cleverness. Visitors should understand the offer immediately.
- Specific beats general. Numbers, examples and concrete outcomes persuade more than adjectives.
- Match awareness. Visitors who know the problem need different copy from those comparing solutions.
- Test messages, not words. Test different value propositions and angles, not synonyms.
Awareness stages
| Stage | Visitor knows | Copy should |
|---|---|---|
| Unaware | Not the problem | Show the problem and its cost |
| Problem aware | The problem, not solutions | Describe the problem in their words, introduce the approach |
| Solution aware | Solutions exist | Explain why this approach works best |
| Product aware | Your product | Show proof, details and handle objections |
| Most aware | Ready to buy | Make the offer and next step clear |
Copy elements and guidelines
| Element | Guideline | Example |
|---|---|---|
| Headline | Outcome for the reader, specific | "Let clients book a time with you in one click" |
| Subheadline | How or for whom | "Share your link; they pick a slot; it lands in your calendar" |
| Call to action | Verb plus outcome | "Start my free trial" rather than "Submit" |
| Benefit bullets | Outcome first, feature second | "Fewer no-shows: automatic reminders by email and SMS" |
| Objection copy | Address the worry directly | "Cancel anytime, no questions asked" |
| Microcopy | Reduce anxiety at decision points | "We'll never share your email" near the email field |
| Error messages | Helpful and specific | "Enter a postcode like SW1A 1AA" |
When to use, and when not to
Use it when pages have traffic but low conversion, when messages differ from what customers say, before launches and redesigns, and when testing value propositions.
Don't use it to define positioning (the Product Marketing positioning and messaging-framework skills) or for email or ad copy in depth (the CRM and Performance Marketing skills).
Inputs to ask for, in one message
- Page and its goal; traffic sources and awareness levels.
- Customer language: reviews, survey answers, interview notes, sales call notes.
- Positioning and messaging framework if available.
- Proof: results, ratings, case studies.
- Current copy and performance data.
- Brand voice guidelines.
Raw SKILL.md file
This is the exact file agents read, including the credit header and licence notice. Save it as conversion-copywriting/SKILL.md.
---
name: conversion-copywriting
description: "Write and test conversion copy from customer language: voice of customer mining, awareness stages, value proposition angles, page copy ordered by visitor questions, outcome-focused calls to action, reassuring microcopy and helpful errors, clarity editing and tests of different messages judged on conversion and revenue. Use whenever someone asks to rewrite website copy for conversion, improve headlines, test value propositions, write calls to action, microcopy, voice of customer research or why copy does not convert."
license: CC-BY-4.0
metadata:
author: Afeez Adebayo
author_url: https://afeezadebayo.com
author_linkedin: https://www.linkedin.com/in/afeez-adebayo/
author_x: https://x.com/za_icon
source: https://afeezadebayo.com/skills-md/marketing/conversion-rate-optimization/conversion-copywriting/
category: marketing
subcategory: conversion-rate-optimization
version: "1.0.0"
created: "2026-10-10"
updated: "2026-10-10"
---
# Conversion Copywriting and Value Proposition Tests
Words decide whether visitors understand an offer and feel ready to act. Many sites describe features in the company's language, lead with clever slogans and bury what the visitor cares about. Conversion copywriting starts from research into what customers want, fear and say, then writes clear, specific copy for each step of the journey and tests the messages that matter most.
This skill writes and improves conversion copy for headlines, value propositions, calls to action, product and pricing pages, forms and checkout microcopy, using customer language and structured tests.
## Operating principles
1. **Research first.** The best phrases come from customers: reviews, surveys, interviews and sales calls.
2. **Clarity before cleverness.** Visitors should understand the offer immediately.
3. **Specific beats general.** Numbers, examples and concrete outcomes persuade more than adjectives.
4. **Match awareness.** Visitors who know the problem need different copy from those comparing solutions.
5. **Test messages, not words.** Test different value propositions and angles, not synonyms.
## Awareness stages
| Stage | Visitor knows | Copy should |
|---|---|---|
| Unaware | Not the problem | Show the problem and its cost |
| Problem aware | The problem, not solutions | Describe the problem in their words, introduce the approach |
| Solution aware | Solutions exist | Explain why this approach works best |
| Product aware | Your product | Show proof, details and handle objections |
| Most aware | Ready to buy | Make the offer and next step clear |
## Copy elements and guidelines
| Element | Guideline | Example |
|---|---|---|
| Headline | Outcome for the reader, specific | "Let clients book a time with you in one click" |
| Subheadline | How or for whom | "Share your link; they pick a slot; it lands in your calendar" |
| Call to action | Verb plus outcome | "Start my free trial" rather than "Submit" |
| Benefit bullets | Outcome first, feature second | "Fewer no-shows: automatic reminders by email and SMS" |
| Objection copy | Address the worry directly | "Cancel anytime, no questions asked" |
| Microcopy | Reduce anxiety at decision points | "We'll never share your email" near the email field |
| Error messages | Helpful and specific | "Enter a postcode like SW1A 1AA" |
## When to use, and when not to
Use it when pages have traffic but low conversion, when messages differ from what customers say, before launches and redesigns, and when testing value propositions.
Don't use it to define positioning (the Product Marketing `positioning` and `messaging-framework` skills) or for email or ad copy in depth (the CRM and Performance Marketing skills).
## Inputs to ask for, in one message
1. Page and its goal; traffic sources and awareness levels.
2. Customer language: reviews, survey answers, interview notes, sales call notes.
3. Positioning and messaging framework if available.
4. Proof: results, ratings, case studies.
5. Current copy and performance data.
6. Brand voice guidelines.
## Workflow
### Step 1. Mine customer language
Collect phrases about the problem, desired outcome, objections and reasons for choosing you. Group by theme.
### Step 2. Identify the visitor's awareness
Based on traffic source and page type.
### Step 3. Write the value proposition
Several versions using different angles (outcome, pain, speed, cost, risk). Pick two or three to test.
### Step 4. Write page copy in order of visitor questions
What is it, who is it for, why it's better, how it works, proof, what it costs, what happens next.
### Step 5. Write calls to action and microcopy
Outcome-focused buttons, reassurance near forms and payment.
### Step 6. Edit for clarity
Short sentences, plain words, one idea per paragraph, scannable headings.
### Step 7. Test
Value proposition and angle tests on high-traffic pages; judge on conversion and revenue.
## Value proposition angles to test
| Angle | Example headline |
|---|---|
| Outcome | "Close your books in two days, not six" |
| Pain removal | "No more month-end spreadsheet marathons" |
| Speed | "Set up in an afternoon, live by Monday" |
| Risk reduction | "Audit-ready numbers, every month" |
| Social proof | "Trusted by 2,000 finance teams" (only if true) |
## Voice of customer worksheet
```
| Theme | Customer phrase (source) | Where to use | Notes |
| Problem | "I dread month-end every time" (survey) | Hero subheadline | Strong emotion |
| Outcome | "We closed in two days" (review) | Proof strip | Has a number |
| Objection | "Worried about switching from Excel" (sales call) | FAQ, near CTA | Answer with migration help |
```
## Call to action examples
| Weak | Stronger |
|---|---|
| Submit | Get my quote |
| Sign up | Start my free trial |
| Learn more | See how it works in 2 minutes |
| Buy now | Add to basket, free delivery over \u00a350 |
| Contact us | Talk to a specialist today |
Buttons that describe what the visitor gets usually outperform generic verbs.
## Editing checklist
- Can a first-time visitor say what the product does after reading the headline?
- Does every paragraph answer a question the visitor has at that point?
- Are claims backed by a number, example or proof?
- Are sentences short and words plain?
- Do headings tell the story when read alone?
- Is there one clear next step?
## Microcopy at decision points
| Location | Example |
|---|---|
| Email field | We send one email a week. Unsubscribe anytime. |
| Card field on trial sign-up | You will not be charged until your trial ends. |
| Pricing toggle | Save two months with annual billing. |
| Checkout button | Secure payment. Free returns within 30 days. |
## Testing rules
Test one message change at a time on pages with enough traffic, keep the design the same so the copy is the variable and judge on conversion and revenue rather than clicks.
## Edge cases and judgement calls
| Situation | What to do |
|---|---|
| Brand voice is very formal or playful | Keep clarity; express voice in tone, not vagueness |
| Technical audience | Specific details and documentation links |
| Regulated industries | Legal review; avoid unproven claims |
| Low traffic | Use research-backed rewrites; test only large differences |
| Multiple languages | Localise rather than translate copy |
## Handoffs to related skills
- Research: `conversion-research`
- Landing pages: `landing-page-optimisation`
- Pricing page copy: `pricing-page-optimisation`
- Proof: `social-proof-trust`
- Test planning: `cro-test-planning`
- Positioning and messaging: the Product Marketing skills
## Worked example
A finance software landing page led with "Next-generation financial intelligence". Survey answers and reviews showed customers talked about dreading month-end and wanting to close faster. Three value propositions were tested: outcome ("Close your books in two days, not six"), pain ("No more month-end spreadsheet marathons") and risk ("Audit-ready numbers, every month"). The outcome version raised demo requests most, and its wording was rolled out to ads and the sales deck.
## Output format
```
# Conversion copy plan: <page>, <date>
## Visitor and awareness stage
## Voice of customer themes
## Value proposition options and test plan
## Page copy (in order of visitor questions)
## Calls to action and microcopy
## Metrics
```
## Common mistakes
- Writing from the company's view instead of the customer's.
- Clever headlines that obscure the offer.
- Generic buttons like "Submit".
- Testing synonyms instead of different messages.
- Claims without proof.
## Questions to ask before you write
- What words do customers use for the problem and outcome?
- What do visitors already know when they arrive?
- What worries stop them from acting?
## Self-check before you answer
- Is copy based on customer language?
- Is the offer clear immediately?
- Are calls to action and microcopy specific?
- Do tests compare different messages?
## Further reading
- Joanna Wiebe and Copyhackers resources: https://copyhackers.com/blog/
- Eugene Schwartz, Breakthrough Advertising (1966), on awareness stages
---
Created by Afeez Adebayo, Marketing, SEO & Growth Expert
Website: https://afeezadebayo.com
LinkedIn: https://www.linkedin.com/in/afeez-adebayo/
X: https://x.com/za_icon
Source: https://afeezadebayo.com/skills-md/marketing/conversion-rate-optimization/conversion-copywriting/
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). You may copy, share and adapt this skill, including for commercial use, as long as you credit Afeez Adebayo and link to the source URL above. Keep this notice in any copy or adapted version.
Workflow
Step 1. Mine customer language
Collect phrases about the problem, desired outcome, objections and reasons for choosing you. Group by theme.
Step 2. Identify the visitor's awareness
Based on traffic source and page type.
Step 3. Write the value proposition
Several versions using different angles (outcome, pain, speed, cost, risk). Pick two or three to test.
Step 4. Write page copy in order of visitor questions
What is it, who is it for, why it's better, how it works, proof, what it costs, what happens next.
Step 5. Write calls to action and microcopy
Outcome-focused buttons, reassurance near forms and payment.
Step 6. Edit for clarity
Short sentences, plain words, one idea per paragraph, scannable headings.
Step 7. Test
Value proposition and angle tests on high-traffic pages; judge on conversion and revenue.
Value proposition angles to test
| Angle | Example headline |
|---|---|
| Outcome | "Close your books in two days, not six" |
| Pain removal | "No more month-end spreadsheet marathons" |
| Speed | "Set up in an afternoon, live by Monday" |
| Risk reduction | "Audit-ready numbers, every month" |
| Social proof | "Trusted by 2,000 finance teams" (only if true) |
Voice of customer worksheet
| Theme | Customer phrase (source) | Where to use | Notes |
| Problem | "I dread month-end every time" (survey) | Hero subheadline | Strong emotion |
| Outcome | "We closed in two days" (review) | Proof strip | Has a number |
| Objection | "Worried about switching from Excel" (sales call) | FAQ, near CTA | Answer with migration help |Call to action examples
| Weak | Stronger |
|---|---|
| Submit | Get my quote |
| Sign up | Start my free trial |
| Learn more | See how it works in 2 minutes |
| Buy now | Add to basket, free delivery over \u00a350 |
| Contact us | Talk to a specialist today |
Buttons that describe what the visitor gets usually outperform generic verbs.
Editing checklist
- Can a first-time visitor say what the product does after reading the headline?
- Does every paragraph answer a question the visitor has at that point?
- Are claims backed by a number, example or proof?
- Are sentences short and words plain?
- Do headings tell the story when read alone?
- Is there one clear next step?
Microcopy at decision points
| Location | Example |
|---|---|
| Email field | We send one email a week. Unsubscribe anytime. |
| Card field on trial sign-up | You will not be charged until your trial ends. |
| Pricing toggle | Save two months with annual billing. |
| Checkout button | Secure payment. Free returns within 30 days. |
Testing rules
Test one message change at a time on pages with enough traffic, keep the design the same so the copy is the variable and judge on conversion and revenue rather than clicks.
Edge cases and judgement calls
| Situation | What to do |
|---|---|
| Brand voice is very formal or playful | Keep clarity; express voice in tone, not vagueness |
| Technical audience | Specific details and documentation links |
| Regulated industries | Legal review; avoid unproven claims |
| Low traffic | Use research-backed rewrites; test only large differences |
| Multiple languages | Localise rather than translate copy |
Handoffs to related skills
- Research:
conversion-research - Landing pages:
landing-page-optimisation - Pricing page copy:
pricing-page-optimisation - Proof:
social-proof-trust - Test planning:
cro-test-planning - Positioning and messaging: the Product Marketing skills
Worked example
A finance software landing page led with "Next-generation financial intelligence". Survey answers and reviews showed customers talked about dreading month-end and wanting to close faster. Three value propositions were tested: outcome ("Close your books in two days, not six"), pain ("No more month-end spreadsheet marathons") and risk ("Audit-ready numbers, every month"). The outcome version raised demo requests most, and its wording was rolled out to ads and the sales deck.
Output format
# Conversion copy plan: <page>, <date>
## Visitor and awareness stage
## Voice of customer themes
## Value proposition options and test plan
## Page copy (in order of visitor questions)
## Calls to action and microcopy
## MetricsCommon mistakes
- Writing from the company's view instead of the customer's.
- Clever headlines that obscure the offer.
- Generic buttons like "Submit".
- Testing synonyms instead of different messages.
- Claims without proof.
Questions to ask before you write
- What words do customers use for the problem and outcome?
- What do visitors already know when they arrive?
- What worries stop them from acting?
Self-check before you answer
- Is copy based on customer language?
- Is the offer clear immediately?
- Are calls to action and microcopy specific?
- Do tests compare different messages?
Further reading
- Joanna Wiebe and Copyhackers resources: https://copyhackers.com/blog/
- Eugene Schwartz, Breakthrough Advertising (1966), on awareness stages
On this page
- When to use this skill, and when not to
- Example prompts
- Example output
- What the agent needs from you
- How this skill hands off to related skills
- How to run Conversion Copywriting step by step
- Situations this skill handles
- What makes this skill different
- Practical tips from real projects
- Frequently asked questions
- Changelog
When to use this skill, and when not to
Use it when pages have traffic but convert poorly, when messages differ from what customers say, before launches and redesigns and when testing value propositions.
Many sites describe features in company language, lead with clever slogans and bury what visitors care about. Conversion copywriting starts from research into what customers want, fear and say, then writes clear, specific copy for each step.
Don’t use it to define positioning (use the Product Marketing Positioning skill) or for email and ad copy in depth (use the CRM and Performance Marketing skills).
Example prompts
- “Test three value propositions for this landing page.”
- “Rewrite our homepage copy in customer language.”
- “Write better calls to action for our sign-up page.”
- “Write reassuring microcopy for our checkout.”
- “Mine these reviews for headline ideas.”
Example output
The skill returns a fixed structure. A shortened example for an imaginary site:
# Conversion copy plan: example finance software, 11 October 2026
Old headline: 'Next-generation financial intelligence'
Customer language: 'I dread month-end'; 'we closed in two days'
Test: outcome ('Close your books in two days, not six') vs pain vs risk
Winner: outcome version; rolled out to ads and sales deckTests compare different messages and angles, not synonyms, so each result teaches something about what buyers value.
What the agent needs from you
The skill asks for the page and goal, traffic sources and awareness levels, customer language from reviews, surveys, interviews and sales calls, positioning and messaging, available proof, current copy and performance, and brand voice guidelines.
How this skill hands off to related skills
Copy connects to the set: customer language from Research, pages in Landing Pages and Pricing Page, proof from Social Proof, scheduling in Test Planning and strategy from the Product Marketing Messaging Framework skill.
How to run Conversion Copywriting step by step
- Install the skill as
conversion-copywriting/SKILL.md. - Mine customer language by theme.
- Identify awareness stage by source.
- Write value proposition options.
- Write page copy, calls to action and microcopy.
- Test messages on busy pages.
Situations this skill handles
Copy needs vary. The skill handles these situations:
| Situation | What the skill does |
|---|---|
| Formal or playful brand voice | Clarity first, voice in tone |
| Technical audience | Specific details and docs |
| Regulated industries | Legal review of claims |
| Low traffic | Research-backed rewrites |
| Multiple languages | Localised copy |
| Clever headline loved internally | Tested against a clear one |
What makes this skill different
Most copywriting starts from a blank page. This skill starts from customer words, writes for what visitors already know and orders copy by the questions they ask.
It tests whole messages and angles, so every test result tells the team something about what buyers value.
Practical tips from real projects
- Research first.
- Clarity before cleverness.
- Specific beats general.
- Test messages, not words.
A worked example: a finance software landing page led with next-generation financial intelligence. Survey answers and reviews showed customers talked about dreading month-end and wanting to close faster. Three value propositions were tested: an outcome version promising to close the books in two days, not six; a pain version promising no more month-end spreadsheet marathons; and a risk version promising audit-ready numbers every month. The outcome version raised demo requests most, and its wording was rolled out to ads and the sales deck.
Awareness stages change what copy must do. Unaware visitors need to see the problem and its cost. Problem-aware visitors need the problem described in their words and an approach introduced. Solution-aware visitors need to know why this approach works best. Product-aware visitors need proof, details and objection handling. The most aware visitors just need a clear offer and next step.
Each element has a rule. Headlines state the outcome for the reader specifically. Subheadlines explain how or for whom. Calls to action pair a verb with an outcome, such as get my quote or start my free trial rather than submit. Benefit bullets lead with outcomes and support them with features. Objection copy addresses the worry directly. Microcopy reduces anxiety at decision points, such as noting that a card will not be charged until a trial ends. Error messages are helpful and specific.
Value proposition angles worth testing include outcome, pain removal, speed, risk reduction and social proof, using only claims that are true.
A voice of customer worksheet records each theme, the customer phrase and its source, where to use it and notes. A survey line about dreading month-end might become a hero subheadline; a review saying we closed in two days might become a proof strip; a sales call worry about switching from spreadsheets might become an FAQ answer near the call to action.
The editing checklist asks whether a first-time visitor can say what the product does after the headline, whether each paragraph answers a question the visitor has at that point, whether claims carry proof, whether sentences are short and words plain, whether headings tell the story alone and whether there is one clear next step.
Testing rules change one message at a time on pages with enough traffic, keep the design constant so copy is the variable and judge results on conversion and revenue rather than clicks.
Copy is written in the order visitors ask questions: what it is, who it is for, why it is better, how it works, proof, what it costs and what happens next.
Customer language is collected continuously from reviews, surveys, interviews, sales calls and support tickets, grouped by problem, outcome, objection and reason for choosing, so writers always have real phrases to draw from.
Brand voice still matters: it shows in tone, rhythm and word choice, never in vagueness. A playful brand can be clear, and a formal brand can be specific. When a clever headline is loved internally, the skill tests it against a clear one and lets visitors decide.
Frequently asked questions
What is conversion copywriting?
Writing page copy from customer research so visitors understand the offer and feel ready to act, then testing the messages that matter most.
Where do the best headlines come from?
Customer words in reviews, surveys, interviews and sales calls.
What are awareness stages?
How much visitors already know, from unaware of the problem to ready to buy, which changes what copy should say.
What makes a good call to action?
A verb plus the outcome the visitor gets, such as start my free trial.
What should copy tests compare?
Different value propositions or angles, not small word changes.
Does microcopy matter?
Yes. Short reassurance near forms, prices and payment reduces anxiety at decision points.
Changelog
- 1.0.0, 10 October 2026: first release.
Use, adapt and share this skill under CC BY 4.0: credit Afeez Adebayo and link to this page.
All Conversion Rate Optimization skills
- CRO Audit
- Conversion Research Methods
- Landing Page and Homepage Optimisation
- Form Optimisation
- Pricing Page Optimisation
- Checkout and Cart Optimisation
- Sign-Up Flow and Onboarding Conversion
- Popups and On-Site Messaging
- Social Proof and Trust Signals
- Mobile Conversion Optimisation
- CRO Test Planning and Prioritisation
- CRO Programme Reporting
