copywriting

Overview of copywriting skill

What the copywriting skill does

The copywriting skill is a marketing-page writing assistant for creating, rewriting, and improving conversion-focused copy. It is designed for pages such as homepages, landing pages, pricing pages, feature pages, product pages, and about pages, where the goal is to move a visitor toward one clear action.

Best fit for copywriting work

Use this copywriting skill when you need structured marketing copy rather than a loose brainstorming session. It is a strong fit for founders, marketers, product teams, and agencies that already know the offer, audience, and desired conversion goal but need sharper messaging, headlines, CTAs, section flow, or page rewrites.

What makes it different from a generic prompt

The skill asks for practical conversion inputs before writing: page type, primary action, audience pain, objections, product differentiation, proof points, and traffic source. It also includes supporting references for headline formulas, page structures, and natural transitions, plus a headline_scorer.py script for evaluating headline options.

When not to use this skill

Do not use copywriting as the first choice for email sequences or popup-specific conversion work; the upstream skill itself points users toward separate email-sequence and popup-cro skills for those cases. It is also not a brand strategy replacement: if positioning, ICP, offer, and proof are unknown, expect the skill to ask clarifying questions before producing useful copy.

How to Use copywriting skill

copywriting install and repository path

Install the skill from the GitHub repository with:

npx skills add alirezarezvani/claude-skills --skill copywriting

The source lives at:

marketing-skill/skills/copywriting

After install, read SKILL.md first because it defines when the agent should trigger the skill and what context it needs before writing. Then review references/copy-frameworks.md, references/natural-transitions.md, and scripts/headline_scorer.py if you want to understand the frameworks and scoring logic behind the output.

Inputs the skill needs before writing

For best copywriting usage, provide the information the skill is built to collect:

• Page type: homepage, landing page, pricing page, feature page, product page, or about page
• One primary action: book a demo, start a trial, buy now, join waitlist, download, contact sales
• Audience: who they are, what they want, what they fear, and how they describe the problem
• Offer: product, service, key outcome, differentiation, and proof
• Context: traffic source, stage of awareness, existing page copy, brand voice, and constraints

If your project has .claude/product-marketing-context.md, the skill is designed to read that first and avoid asking for context already documented there.

Turn a rough request into a strong prompt

A weak prompt is: “Write copy for my landing page.”

A stronger prompt is:

“Use the copywriting skill to rewrite a landing page for a B2B SaaS analytics tool. The primary CTA is Start free trial. The audience is ecommerce operators who cannot see which campaigns create profitable repeat buyers. Main objection: they already have GA4 but find it hard to use. Differentiator: cohort revenue and retention insights without SQL. Proof: used by 1,200 Shopify stores, average 18% lift in repeat purchase rate. Traffic comes from Google Search for customer retention analytics. Keep the tone clear, direct, and not hype-heavy. Return hero, problem section, benefits, proof section, FAQ, and CTAs.”

This works better because the skill can connect the headline, proof, objections, and CTA to a specific conversion job instead of inventing generic benefits.

Practical workflow for better output

Start with one page goal, not a full website. Ask for a page outline before final copy if the offer is complex. Then request multiple headline angles using the frameworks in references/copy-frameworks.md, such as outcome-focused, problem-focused, audience-focused, differentiation-focused, and proof-focused headlines.

For headlines, you can run the helper script after cloning or browsing the repository:

python3 scripts/headline_scorer.py "Turn repeat buyers into predictable revenue"

Use the score as a diagnostic, not an absolute truth. A high-scoring headline can still be wrong if it overpromises, misrepresents the product, or does not match visitor intent.

copywriting skill FAQ

Is this copywriting skill beginner-friendly?

Yes, if you can answer basic questions about your offer and audience. The skill’s intake structure helps beginners avoid the most common mistake: asking for “better copy” without defining the reader, action, objection, or proof. Beginners should start by pasting existing copy and asking for diagnosis before requesting a full rewrite.

How is it better than ordinary copywriting prompts?

Ordinary prompts often produce polished but generic copy. This skill is more useful because it forces page-purpose discipline, audience specificity, objection handling, and proof-driven messaging. The included reference files also give the agent concrete headline and transition patterns instead of relying only on broad model memory.

Can it write copy for any industry?

It can adapt to many industries, but output quality depends on input quality. For regulated, technical, medical, legal, or financial offers, provide approved claims, prohibited claims, compliance notes, and required disclaimers. The skill can improve clarity and structure, but it should not invent evidence or make claims your business cannot support.

Does it replace a human conversion copywriter?

No. It speeds up first drafts, rewrites, headline exploration, page structure, and CTA testing ideas. A human still needs to validate positioning, customer research, legal accuracy, brand nuance, and conversion data. Treat it as a production and critique assistant, not as final approval authority.

How to Improve copywriting skill

Improve copywriting with sharper source material

The fastest way to improve copywriting output is to give the skill real customer language. Add snippets from sales calls, reviews, support tickets, surveys, search queries, and competitor comparison pages. Replace vague claims like “saves time” with specific outcomes such as “cuts weekly reporting from 4 hours to 20 minutes.”

Avoid common failure modes

Watch for three issues: generic benefits, unsupported proof, and mismatched tone. If the output says “boost productivity” or “streamline workflows,” ask it to replace abstractions with concrete before/after outcomes. If it adds numbers or claims you did not provide, ask for a version using only verified proof. If the tone feels too salesy, provide examples of copy your brand would and would not say.

Iterate after the first draft

Do not stop at the first output. Ask for targeted passes:

• “Make the hero section clearer for cold organic traffic.”
• “Rewrite the CTA copy for a skeptical buyer.”
• “Add objection handling for teams that already use spreadsheets.”
• “Create five headline variants: outcome, pain, proof, differentiation, and audience.”
• “Shorten the pricing-page copy without losing the main value proposition.”

These focused revisions produce better results than asking for a full rewrite repeatedly.

Use the repository references deliberately

Read references/copy-frameworks.md when you need more headline and section structure options. Read references/natural-transitions.md when page copy feels jumpy or AI-generated. Use scripts/headline_scorer.py to compare headline candidates, then choose based on message-market fit, search intent, and conversion context rather than score alone.