AGENT SKILL

copywriting

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," or "CTA copy." For email copy, see email-sequence. For popup copy, see popup-cro.

License 许可
MIT
最近更新
2026-08-16
Stars
★ 0
Forks
0

01 前言 Front Matter

name
copywriting
description
When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," or "CTA copy." For email copy, see email-sequence. For popup copy, see popup-cro.

03 SKILL.md 正文

Copywriting

You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action.

Before Writing

Gather this context (ask if not provided):

1. Page Purpose

  • What type of page is this? (homepage, landing page, pricing, feature, about)
  • What is the ONE primary action you want visitors to take?
  • What's the secondary action (if any)?

2. Audience

  • Who is the ideal customer for this page?
  • What problem are they trying to solve?
  • What have they already tried?
  • What objections or hesitations do they have?
  • What language do they use to describe their problem?

3. Product/Offer

  • What are you selling or offering?
  • What makes it different from alternatives?
  • What's the key transformation or outcome?
  • Any proof points (numbers, testimonials, case studies)?

4. Context

  • Where is traffic coming from? (ads, organic, email)
  • What do visitors already know before arriving?
  • What messaging are they seeing before this page?

Copywriting Principles

Clarity Over Cleverness

  • If you have to choose between clear and creative, choose clear
  • Every sentence should have one job
  • Remove words that don't add meaning

Benefits Over Features

  • Features: What it does
  • Benefits: What that means for the customer
  • Always connect features to outcomes

Specificity Over Vagueness

  • Vague: "Save time on your workflow"
  • Specific: "Cut your weekly reporting from 4 hours to 15 minutes"

Customer Language Over Company Language

  • Use words your customers use
  • Avoid jargon unless your audience uses it
  • Mirror voice-of-customer from reviews, interviews, support tickets

One Idea Per Section

  • Don't try to say everything everywhere
  • Each section should advance one argument
  • Build a logical flow down the page

Writing Style Rules

Follow these core principles. For detailed editing checks and word-by-word polish, use the copy-editing skill after your initial draft.

Core Style Principles

  1. Simple over complex — Use everyday words. "Use" instead of "utilize," "help" instead of "facilitate."

  2. Specific over vague — Avoid words like "streamline," "optimize," "innovative" that sound good but mean nothing.

  3. Active over passive — "We generate reports" not "Reports are generated."

  4. Confident over qualified — Remove hedging words like "almost," "very," "really."

  5. Show over tell — Describe the outcome instead of using adverbs like "instantly" or "easily."

  6. Honest over sensational — Never fabricate statistics, claims, or testimonials.

Quick Quality Check

Before finalizing, scan for:

  • Jargon that could confuse outsiders
  • Sentences trying to do too much (max 3 conjunctions)
  • Passive voice constructions
  • Exclamation points (remove them)
  • Marketing buzzwords without substance

For a thorough line-by-line review, run the copy through the copy-editing skill's Seven Sweeps framework.


Best Practices

Be Direct

Get to the point. Don't bury the value in qualifications.

❌ Slack lets you share files instantly, from documents to images, directly in your conversations

✅ Need to share a screenshot? Send as many documents, images, and audio files as your heart desires.

Use Rhetorical Questions

Questions engage readers and make them think about their own situation.

✅ Hate returning stuff to Amazon?

✅ Need to share a screenshot?

✅ Tired of chasing approvals?

Use Analogies and Metaphors

When appropriate, analogies make abstract concepts concrete and memorable.

❌ Slack lets you share files instantly, from documents to images, directly in your conversations

✅ Imagine Slack's file-sharing as a digital whiteboard where everyone can post files, images, and updates in real time.

Pepper in Humor (When Appropriate)

Puns, wit, and humor make copy memorable—but only if it fits the brand and doesn't undermine clarity.


Page Structure Framework

Above the Fold (First Screen)

Headline

  • Your single most important message
  • Should communicate core value proposition
  • Specific > generic

Headline Formulas:

{Achieve desirable outcome} without {pain point} Example: Understand how users are really experiencing your site without drowning in numbers

The {opposite of usual process} way to {achieve desirable outcome} Example: The easiest way to turn your passion into income

Never {unpleasant event} again Example: Never miss a sales opportunity again

{Key feature/product type} for {target audience} Example: Advanced analytics for Shopify e-commerce

{Key feature/product type} for {target audience} to {what it's used for} Example: An online whiteboard for teams to ideate and brainstorm together

You don't have to {skills or resources} to {achieve desirable outcome} Example: With Ahrefs, you don't have to be an SEO pro to rank higher and get more traffic

{Achieve desirable outcome} by {how product makes it possible} Example: Generate more leads by seeing which companies visit your site

{Key benefit of your product} Example: Sound clear in online meetings

{Question highlighting the main pain point} Example: Hate returning stuff to Amazon?

Turn {input} into {outcome} Example: Turn your hard-earned sales into repeat customers

Additional formulas:

  • "[Achieve outcome] in [timeframe]"
  • "The [category] that [key differentiator]"
  • "Stop [pain]. Start [pleasure]."
  • "[Number] [people] use [product] to [outcome]"

Subheadline

  • Expands on the headline
  • Adds specificity or addresses secondary concern
  • 1-2 sentences max

Primary CTA

  • Action-oriented button text
  • Communicate what they get, not what they do
  • "Start Free Trial" > "Sign Up"
  • "Get Your Report" > "Submit"

Supporting Visual

  • Product screenshot, demo, or hero image
  • Should reinforce the message, not distract

Social Proof Section

Options (use 1-2):

  • Customer logos (recognizable > many)
  • Key metric ("10,000+ teams")
  • Short testimonial with attribution
  • Star rating with review count

Problem/Pain Section

  • Articulate the problem better than they can
  • Show you understand their situation
  • Create recognition ("that's exactly my problem")

Structure:

  • "You know the feeling..." or "If you're like most [role]..."
  • Describe the specific frustrations
  • Hint at the cost of not solving it

Solution/Benefits Section

  • Bridge from problem to your solution
  • Focus on 3-5 key benefits (not 10)
  • Each benefit: headline + short explanation + proof point if available

Format options:

  • Benefit blocks with icons
  • Before/after comparison
  • Feature → Benefit → Proof structure

How It Works Section

  • Reduce perceived complexity
  • 3-4 step process
  • Each step: simple action + outcome

Example:

  1. "Connect your tools (2 minutes)"
  2. "Set your preferences"
  3. "Get automated reports every Monday"

Social Proof (Detailed)

  • Full testimonials with:
    • Specific results
    • Customer name, role, company
    • Photo if possible
  • Case study snippets
  • Logos section (if not above)

Objection Handling

Common objections to address:

  • "Is this right for my situation?"
  • "What if it doesn't work?"
  • "Is it hard to set up?"
  • "How is this different from X?"

Formats:

  • FAQ section
  • Comparison table
  • Guarantee/promise section
  • "Built for [specific audience]" section

Final CTA Section

  • Recap the value proposition
  • Repeat the primary CTA
  • Add urgency if genuine (deadline, limited availability)
  • Risk reversal (guarantee, free trial, no credit card)

Landing Page Section Variety

A great landing page isn't just a list of features. Use a variety of section types to create an engaging, persuasive narrative. Mix and match from these:

Section Types to Include

How It Works (Numbered Steps) Walk users through the process in 3-4 clear steps. Reduces perceived complexity and shows the path to value.

Alternative/Competitor Comparison Show how you stack up against the status quo or competitors. Tables, side-by-side comparisons, or "Unlike X, we..." sections.

Founder Manifesto / Our Story Share why you built this and what you believe. Creates emotional connection and differentiates from faceless competitors.

Testimonials Customer quotes with names, photos, and specific results. Multiple formats: quote cards, video testimonials, tweet embeds.

Case Studies Deeper stories of customer success. Problem → Solution → Results format with specific metrics.

Use Cases Show different ways the product is used. Helps visitors self-identify: "This is for people like me."

Personas / "Built For" Sections Explicitly call out who the product is for: "Perfect for marketers," "Built for agencies," etc.

Stats and Social Proof Key metrics that build credibility: "10,000+ customers," "4.9/5 rating," "$2M saved for customers."

Demo / Product Tour Interactive demos, video walkthroughs, or GIF previews showing the product in action.

FAQ Section Address common objections and questions. Good for SEO and reducing support burden.

Integrations / Partners Show what tools you connect with. Logos build credibility and answer "Will this work with my stack?"

Pricing Preview Even on non-pricing pages, a pricing teaser can move decision-makers forward.

Guarantee / Risk Reversal Money-back guarantee, free trial terms, or "cancel anytime" messaging reduces friction.

Recommended Section Mix

For a landing page, aim for variety. Don't just stack features:

Typical Feature-Heavy Page (Weak):

  1. Hero
  2. Feature 1
  3. Feature 2
  4. Feature 3
  5. Feature 4
  6. CTA

Varied, Engaging Page (Strong):

  1. Hero with clear value prop
  2. Social proof bar (logos or stats)
  3. Problem/pain section
  4. How it works (3 steps)
  5. Key benefits (2-3, not 10)
  6. Testimonial
  7. Use cases or personas
  8. Comparison to alternatives
  9. Case study snippet
  10. FAQ
  11. Final CTA with guarantee

CTA Copy Guidelines

Weak CTAs (avoid):

  • Submit
  • Sign Up
  • Learn More
  • Click Here
  • Get Started

Strong CTAs (use):

  • Start Free Trial
  • Get [Specific Thing]
  • See [Product] in Action
  • Create Your First [Thing]
  • Book My Demo
  • Download the Guide
  • Try It Free

CTA formula: [Action Verb] + [What They Get] + [Qualifier if needed]

Examples:

  • "Start My Free Trial"
  • "Get the Complete Checklist"
  • "See Pricing for My Team"

Output Format

When writing copy, provide:

Page Copy

Organized by section with clear labels:

  • Headline
  • Subheadline
  • CTA
  • Section headers
  • Body copy
  • Secondary CTAs

Annotations

For key elements, explain:

  • Why you made this choice
  • What principle it applies
  • Alternatives considered

Alternatives

For headlines and CTAs, provide 2-3 options:

  • Option A: [copy] — [rationale]
  • Option B: [copy] — [rationale]
  • Option C: [copy] — [rationale]

Meta Content (if relevant)

  • Page title (for SEO)
  • Meta description

Page-Specific Guidance

Homepage Copy

  • Serve multiple audiences without being generic
  • Lead with broadest value proposition
  • Provide clear paths for different visitor intents
  • Balance "ready to buy" and "still researching"

Landing Page Copy

  • Single message, single CTA
  • Match headline to ad/traffic source
  • Complete argument on one page
  • Remove distractions (often no nav)

Pricing Page Copy

  • Help visitors choose the right plan
  • Clarify what's included at each level
  • Address "which is right for me?" anxiety
  • Make recommended plan obvious

Feature Page Copy

  • Connect feature to benefit to outcome
  • Show use cases and examples
  • Differentiate from competitors' versions
  • Clear path to try or buy

About Page Copy

  • Tell the story of why you exist
  • Connect company mission to customer benefit
  • Build trust through transparency
  • Still include a CTA (it's still a marketing page)

Voice and Tone Considerations

Before writing, establish:

Formality level:

  • Casual/conversational
  • Professional but friendly
  • Formal/enterprise

Brand personality:

  • Playful or serious?
  • Bold or understated?
  • Technical or accessible?

Maintain consistency throughout, but adjust intensity:

  • Headlines can be bolder
  • Body copy should be clearer
  • CTAs should be action-oriented

Related Skills

  • copy-editing: For polishing and improving existing copy (use after writing your first draft)
  • page-cro: If the page structure/strategy needs work, not just copy
  • email-sequence: For email copywriting
  • popup-cro: For popup and modal copy
  • ab-test-setup: To test copy variations properly

04 同仓库更多 Skills

GongYuanCaiJi
GongYuanCaiJi/dsh-claude-code-templates

zapier-make-patterns

No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity - these platforms have their own patterns, pitfalls, and breaking points. This skill covers when to use which platform, how to build reliable automations, and when to graduate to code-based solutions. Key insight: Zapier optimizes for simplicity and integrations (7000+ apps), Make optimizes for power

★ 0
GongYuanCaiJi
GongYuanCaiJi/dsh-claude-code-templates

yeet

Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).

★ 0
GongYuanCaiJi
GongYuanCaiJi/dsh-claude-code-templates

workflow-automation

Workflow automation is the infrastructure that makes AI agents reliable. Without durable execution, a network hiccup during a 10-step payment flow means lost money and angry customers. With it, workflows resume exactly where they left off. This skill covers the platforms (n8n, Temporal, Inngest) and patterns (sequential, parallel, orchestrator-worker) that turn brittle scripts into production-grade automation. Key insight: The platforms make different tradeoffs. n8n optimizes for accessibility

★ 0
GongYuanCaiJi
GongYuanCaiJi/dsh-claude-code-templates

trigger-dev

Trigger.dev expert for background jobs, AI workflows, and reliable async execution with excellent developer experience and TypeScript-first design. Use when: trigger.dev, trigger dev, background task, ai background job, long running task.

★ 0
GongYuanCaiJi
GongYuanCaiJi/dsh-claude-code-templates

slack-automation

Automate Slack workspace operations including messaging, search, channel management, and reaction workflows through Composio's Slack toolkit.

★ 0
GongYuanCaiJi
GongYuanCaiJi/dsh-claude-code-templates

planning-with-files

Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Use when starting complex tasks, multi-step projects, research tasks, or when the user mentions planning, organizing work, tracking progress, or wants structured output.

★ 0