borghei/copywriting
> Write persuasive marketing copy for homepages, landing, pricing, feature, and product pages using headline formulas, CTA frameworks, and objection handling. Use when writing page copy, improving headlines, crafting CTAs, or conversion copy.
npx skills add https://github.com/borghei/Claude-Skills --skill copywriting
Conversion-focused marketing copy that is clear, compelling, and drives action across every page type.
copywriting, marketing copy, conversion copy, headline writing, CTA copy, landing page copy, homepage copy, pricing page copy, feature page copy, persuasive writing, value proposition, benefit-driven copy, sales copy, page copy, web copy, product copy, SaaS copy, PAS framework, AIDA framework, BAB framework, objection handling
Before writing the copy, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
If you have to choose between clear and creative, choose clear. A confused reader does not convert.
Features describe what it does. Benefits describe what it means for the customer.
| Feature | Benefit |
|---------|---------|
| "Real-time analytics dashboard" | "See exactly what's working right now — no waiting for reports" |
| "AI-powered recommendations" | "Get suggestions that actually match your data, not generic advice" |
| "99.99% uptime SLA" | "Your customers never see a down page" |
| "SOC 2 Type II certified" | "Pass your enterprise security review without the 6-month scramble" |
Mirror the words your customers use. Pull language from reviews, support tickets, sales calls, and interviews.
Each section advances one argument. Build a logical flow down the page: problem > solution > proof > action.
Never fabricate statistics, testimonials, or claims. Exaggeration erodes trust. Specificity and honesty convert better than hype.
Best for: landing pages, email subject lines, ad copy, product pages
[Problem]: Name the pain in the reader's language
[Agitate]: Show what happens if they don't fix it
[Solution]: Introduce your product as the answer
Example:
> Your team spends 4 hours every week manually compiling reports. That is 200 hours a year — the equivalent of losing a full-time employee to spreadsheets. [Product] automates your reporting in 10 minutes. Set it once, get reports delivered every Monday morning.
Best for: homepage, awareness campaigns, long-form sales pages
[Attention]: Bold statement or surprising claim
[Interest]: Expand with relevant details
[Desire]: Show proof and paint the transformation
[Action]: Clear CTA
Best for: case studies, testimonial framing, email sequences
[Before]: Current painful state
[After]: Desired future state
[Bridge]: How your product gets them there
Best for: sales pages, feature pages, product launches
[Promise]: State the key benefit
[Picture]: Help them visualize the outcome
[Proof]: Show evidence it works
[Push]: Call to action with urgency
Best for: long-form content, webinar scripts, nurture sequences
[Qualify]: Identify the right audience
[Understand]: Show you get their problem
[Educate]: Teach them something valuable
[Stimulate]: Create excitement about the solution
[Transition]: Move to the ask
The homepage serves multiple audiences. Lead with the broadest value proposition.
| Section | Purpose | Guidelines |
|---------|---------|------------|
| Hero | Communicate core value in 5 seconds | Headline + subheadline + primary CTA + visual |
| Social proof bar | Build instant credibility | Customer logos, review scores, or customer count |
| Problem statement | Show you understand their pain | 2-3 pain points in their language |
| Solution overview | Present your answer (3-5 key benefits) | Benefit-first, not feature-first |
| How it works | Reduce perceived complexity | 3-4 steps maximum |
| Use cases | Help different audiences see themselves | 2-3 use case tabs or sections |
| Testimonials | Proof from real customers | Named, specific, with measurable outcomes |
| Objection handling | Remove barriers | FAQ or guarantee section |
| Final CTA | Repeat the ask | Recap value + CTA + risk reversal |
Single message, single CTA. Everything on the page serves one conversion goal.
| Section | Purpose | Guidelines |
|---------|---------|------------|
| Hero | Match headline to traffic source | Exact message match with ad or email |
| Value proposition | One clear benefit | Subheadline expands on headline |
| Problem / Pain | Why they need this now | 2-3 bullet points of pain |
| Solution | What they get | Feature > Benefit mapping |
| Social proof | Relevant proof | Testimonial from similar customer |
| CTA | The one ask | Action verb + what they get |
| Risk reversal | Remove hesitation | Guarantee, no CC, cancel anytime |
Help visitors choose the right plan. Reduce comparison anxiety.
| Section | Purpose | Guidelines |
|---------|---------|------------|
| Value summary | Remind them why before asking for money | One line connecting price to value |
| Plan comparison | Help them choose | 2-4 tiers, recommended plan highlighted |
| Feature matrix | Detailed comparison | Checkmarks with tooltips for complex features |
| FAQ | Address pricing objections | "Can I switch plans?", "What happens after trial?" |
| Social proof | Proof near the buy button | Testimonial or customer count |
| Enterprise CTA | Catch high-value prospects | "Need custom pricing? Talk to us" |
Connect every feature to a business outcome.
| Section | Purpose | Guidelines |
|---------|---------|------------|
| Feature hero | What it does + why it matters | Headline = outcome, subheadline = mechanism |
| Visual demo | Show it in action | Screenshot, GIF, or video |
| Benefits | Why this feature matters | 3-4 benefits with "which means..." bridges |
| Use case | Concrete scenario | "When [situation], you can [action] to [outcome]" |
| Technical details | For evaluators | Expandable section for technical specs |
| Related features | Cross-sell | Links to complementary features |
| CTA | Drive trial or demo | "Try [feature] free" or "See it in action" |
[Achieve outcome] without [pain point]
[Achieve outcome] in [timeframe]
Stop [pain point]. Start [desired state].
[Pain point] is costing you [specific cost]
The [category] for [specific audience]
[Category], but [key differentiator]
[Number] [people/companies] [outcome]
[Specific customer] [specific result] with [Product]
[Question that highlights pain]?
For every page, generate minimum 5 headline options across different formula types:
Select the strongest. Test the top 2-3 if possible.
[Action Verb] + [What They Get] + [Qualifier if needed]
| Weak (avoid) | Moderate | Strong (use) |
|-------------|----------|-------------|
| Submit | Sign Up | Start My Free Trial |
| Click Here | Get Started | Get the Complete Checklist |
| Learn More | Try Free | See [Product] in Action |
| Contact Us | Book a Demo | Create My First [Thing] |
| Send | Download | Get My Free Analysis |
Match CTA friction to visitor readiness:
| Visitor State | CTA Friction Level | Examples |
|-------------|-------------------|---------|
| Cold (first visit) | Very low | "See how it works," "Watch 2-min demo" |
| Warm (return visit) | Low | "Start free trial," "Try it free" |
| Hot (pricing page) | Medium | "Start my plan," "Get started today" |
| Returning (abandoned) | Low + urgency | "Pick up where you left off" |
Below the CTA button, reduce friction:
| Objection | Where to Address | Copy Approach |
|-----------|-----------------|---------------|
| "Too expensive" | Pricing page, FAQ | ROI framing: "Saves X hours/week at $Y/hour = $Z saved" |
| "Not sure it works" | Social proof sections | Named testimonials with specific metrics |
| "Too complex to set up" | How it works section | "3 steps, 10 minutes, no code required" |
| "What if I don't like it?" | Near CTA | Guarantee: "30-day money-back, no questions asked" |
| "I need to check with my team" | Near CTA | "Share a free trial with your team" |
| "Is it secure?" | Trust section or footer | Certifications: "SOC 2, GDPR, ISO 27001" |
| "Will it integrate?" | Feature or FAQ section | "Connects with 200+ tools including [key ones]" |
Position risk reversals near CTAs:
| Level | When | Example |
|-------|------|---------|
| Casual | Consumer, community, social | "Let's make your reporting suck less." |
| Conversational | SaaS, mid-market, blog | "Your weekly reports shouldn't take 4 hours." |
| Professional | B2B, enterprise, sales | "Reduce reporting overhead by 80% with automated dashboards." |
| Formal | Legal, healthcare, finance | "Our platform ensures compliance with regulatory reporting requirements." |
| Bold | Understated |
|------|------------|
| "We built the fastest analytics platform. Period." | "Our analytics platform is designed for speed." |
| Strong opinions, definitive statements | Measured claims, qualified statements |
| Best for: Startups, challenger brands | Best for: Enterprise, regulated industries |
10. Test headlines relentlessly — The headline is the highest-leverage element on any page. A/B test the top 2-3 options.
| Symptom | Likely Cause | Fix |
|---------|-------------|-----|
| Page not converting despite traffic | Headline-to-traffic mismatch or weak CTA | Verify headline matches the ad/email source. Run headline_scorer.py. |
| Visitors bounce without scrolling | Hero section fails the 5-second test | Rewrite headline: benefit + specificity. Remove jargon. |
| High scroll depth but no clicks | CTA is weak, buried, or too many options | Run cta_optimizer.py. Place CTA above fold and after every major section. |
| Copy sounds like a brochure | Too company-focused, not customer-focused | Run page_copy_auditor.py. Ensure you/your outnumbers we/our 2:1. |
| Features listed without impact | Missing "which means..." bridges | Connect every feature to a business outcome the reader cares about. |
| Social proof feels generic | "Great product!" without specifics | Replace with named testimonials + specific metrics + outcomes. |
| Pricing page has high drop-off | No objection handling or risk reversal | Add FAQ, guarantees, and "no credit card required" near CTA. |
In Scope: Marketing page copy for homepages, landing pages, pricing pages, feature pages, and product pages. Headline formulas, CTA frameworks, objection handling, voice calibration.
Out of Scope: Ad copy (use ad-creative), email copy (use email-sequence), blog/content writing (use content-creator), page design/code (use landing-page-generator), copy editing (use copy-editing).
scripts/headline_scorer.py)Scores marketing headlines for clarity, benefit strength, specificity, and conversion potential.
python scripts/headline_scorer.py "Build landing pages in minutes without writing code"
python scripts/headline_scorer.py --file headlines.txt --json
scripts/cta_optimizer.py)Analyzes and scores CTA text for action strength, specificity, ownership language, and friction level.
python scripts/cta_optimizer.py "Start my free trial"
python scripts/cta_optimizer.py --file ctas.txt --json
scripts/page_copy_auditor.py)Audits marketing page copy for customer focus, specificity, social proof, CTA presence, objection handling, and readability.
python scripts/page_copy_auditor.py page.txt
python scripts/page_copy_auditor.py page.html --json
Take borghei/copywriting from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.