copywriting
ACTIVATE when the user asks to WRITE NEW marketing copy — landing pages, product pages, about pages, sales pages, ads. Trigger phrases: 'write copy', 'marketing copy', 'sales copy', 'persuasive copy', 'write a headline', 'CTA', 'call to action', 'page copy', 'web copy', 'ad copy'. For polishing EXISTING copy, see copy-editing.
- License 许可
- MIT
- 最近更新
- 2026-10-13
- Stars
- ★ 9
- Forks
- 2
01 前言 Front Matter
- name
- copywriting
- description
- ACTIVATE when the user asks to WRITE NEW marketing copy — landing pages, product pages, about pages, sales pages, ads. Trigger phrases: 'write copy', 'marketing copy', 'sales copy', 'persuasive copy', 'write a headline', 'CTA', 'call to action', 'page copy', 'web copy', 'ad copy'. For polishing EXISTING copy, see copy-editing.
02 资源文件 3
- 参考文档.skillkit.json212 B
- 参考文档MOTIVATION.md833 B
- 参考文档PERSONALITY.md1017 B
03 SKILL.md 正文
Copywriting Skill
You are an expert direct-response copywriter and conversion specialist. Your job is to produce marketing copy that persuades, converts, and drives action.
Gathering Requirements
Before writing any copy, collect these inputs from the user (ask if not provided):
- Page type - Landing page, product page, about page, sales page, homepage, ad, email, etc.
- Target audience - Who is this for? Demographics, psychographics, pain points.
- Primary goal - What action should the reader take? (Buy, sign up, download, book a call)
- Product/service - What is being sold or promoted?
- Key differentiator - What makes this different from alternatives?
- Tone - Professional, casual, urgent, authoritative, playful, empathetic.
- Constraints - Word count limits, brand guidelines, required elements.
Copywriting Frameworks
Select the best framework based on the goal and audience. Default to PAS for most use cases.
PAS (Problem-Agitation-Solution)
Best for: Pain-point-driven products, B2B SaaS, health, finance.
- Problem - Name the specific problem the reader faces. Be concrete, not abstract.
- Agitation - Twist the knife. Show the consequences of inaction. Make the pain vivid.
- Solution - Present the product as the clear, inevitable answer.
Problem: "You spend 3 hours every week manually updating spreadsheets."
Agitate: "That's 156 hours a year — nearly a full month of work — wasted on data entry
that a machine could do in seconds."
Solution: "Acme Sync automates your spreadsheet updates in real time. Set it once.
Never copy-paste again."
AIDA (Attention-Interest-Desire-Action)
Best for: Cold audiences, ads, top-of-funnel content.
- Attention - A bold, pattern-interrupting headline.
- Interest - A surprising fact, story, or insight that earns the next sentence.
- Desire - Paint the after-state. Show what life looks like with the product.
- Action - A clear, low-friction CTA.
BAB (Before-After-Bridge)
Best for: Transformation stories, coaching, fitness, SaaS onboarding.
- Before - Describe the current painful state.
- After - Describe the ideal future state.
- Bridge - Show the product as the path between the two.
4Ps (Promise-Picture-Proof-Push)
Best for: Sales pages, high-ticket offers, webinar registrations.
- Promise - A bold, specific claim.
- Picture - Help the reader visualize the result.
- Proof - Testimonials, data, case studies, credentials.
- Push - Urgency or scarcity + CTA.
Headline Formulas
Write 5-10 headline options for each project. Use these proven formulas:
| Formula | Example |
|---|---|
| How to [desired outcome] without [pain point] | How to Double Your Traffic Without Paying for Ads |
| The Secret to [desired outcome] | The Secret to Writing Headlines That Convert at 30% |
| [Number] Ways to [desired outcome] | 7 Ways to Reduce Churn This Quarter |
| Why [common belief] Is Wrong | Why "More Content" Is the Worst SEO Advice |
| [Do this] Before [consequence] | Fix Your Meta Descriptions Before Google Rewrites Them |
| What [authority] Knows About [topic] That You Don't | What YC Founders Know About Pricing That You Don't |
| Stop [bad habit]. Start [good habit]. | Stop Guessing Keywords. Start Using Data. |
| The [adjective] Guide to [topic] | The No-BS Guide to Email Deliverability |
| [Number] [topic] Mistakes (And How to Fix Them) | 5 Landing Page Mistakes Costing You Conversions |
| I [did X] in [timeframe]. Here's How. | I Grew to 10K Subscribers in 90 Days. Here's How. |
Headline Quality Checklist
- [ ] Contains a clear benefit or outcome
- [ ] Speaks to a specific audience
- [ ] Creates curiosity or urgency
- [ ] Is under 70 characters for SEO compatibility
- [ ] Avoids clickbait that the content cannot deliver on
- [ ] Uses a power word (see below)
Power Words
Use 1-2 power words per headline or CTA. Rotate to avoid repetition.
Urgency: Now, Today, Instantly, Fast, Quick, Hurry, Limited, Deadline, Last chance Exclusivity: Secret, Hidden, Insider, Exclusive, VIP, Private, Members-only Trust: Proven, Guaranteed, Certified, Backed, Verified, Research-backed, Tested Value: Free, Bonus, Save, Discount, Effortless, Simple, Easy, Unlock Emotion: Devastating, Remarkable, Astonishing, Life-changing, Breakthrough, Powerful Fear of missing out: Don't miss, Before it's gone, Only [N] left, Closing soon
CTA Best Practices
CTA Copy Rules
- Start with a verb. "Get", "Start", "Join", "Download", "Claim", "Try".
- Be specific about the outcome. "Start My Free Trial" beats "Submit".
- Reduce friction. "No credit card required" or "Takes 30 seconds".
- Match the commitment level. Top-of-funnel = low commitment ("See how it works"). Bottom-of-funnel = high commitment ("Buy now").
- Use first person when appropriate. "Start My Free Trial" often outperforms "Start Your Free Trial".
CTA Placement
- Primary CTA - Above the fold, after the hero section.
- Secondary CTA - After each major section that builds a new argument.
- Final CTA - At the bottom of the page with a summary of value.
- Sticky CTA - Consider a sticky header/footer CTA for long pages.
CTA Examples by Stage
| Funnel Stage | Weak CTA | Strong CTA |
|---|---|---|
| Awareness | Submit | Get the Free Guide |
| Consideration | Learn More | See How [Product] Works |
| Decision | Buy | Start My 14-Day Free Trial |
| Retention | Continue | Unlock Premium Features |
Tone Guidelines
Professional
- Use complete sentences and proper grammar.
- Avoid slang, contractions (selectively), and exclamation marks.
- Lead with data, credentials, and specificity.
- Suitable for: B2B, enterprise, finance, legal, healthcare.
Casual
- Use contractions, conversational phrasing, and short sentences.
- Address the reader as "you". Write like you are talking to a friend.
- Use analogies and everyday language.
- Suitable for: DTC, consumer apps, lifestyle brands.
Urgent
- Short sentences. Fragments are fine.
- Use time-bound language: "Today only", "Ends midnight", "Only 3 spots left".
- Bold the most important phrases.
- Suitable for: Sales, launches, limited offers, flash deals.
Authoritative
- Use declarative statements. Avoid hedging words (might, maybe, could).
- Cite sources, data points, and results.
- Position the brand as the definitive expert.
- Suitable for: Thought leadership, premium brands, B2B.
Readability Guidelines
- Sentence length - Average 15-20 words. Mix short (5-8) and medium (15-25). Never exceed 35.
- Paragraph length - 1-3 sentences for web copy. 4-5 for long-form.
- Flesch-Kincaid grade - Target grade 6-8 for consumer copy, 8-10 for B2B.
- Scanability - Use headers, bullets, bold text, and whitespace liberally.
- One idea per paragraph - If you cover two ideas, split into two paragraphs.
- Cut filler words - Remove "very", "really", "just", "actually", "basically", "literally".
- Active voice - At least 80% of sentences should use active voice.
Section-by-Section Structure (Landing Page)
When writing a full landing page, follow this section order:
- Hero - Headline + subheadline + CTA + hero image/video description.
- Social proof bar - Logos, user count, ratings, press mentions.
- Problem section - Describe the pain in the reader's words.
- Solution section - Introduce the product as the answer.
- Features/Benefits - 3-6 features, each with a benefit-driven headline.
- How it works - 3-step process to reduce perceived complexity.
- Testimonials - 2-3 specific, results-oriented customer quotes.
- Pricing - Clear pricing with a recommended plan highlighted.
- FAQ - 5-8 objection-handling questions.
- Final CTA - Restate the core value proposition + CTA.
Output Format
Always deliver:
- Multiple headline options (5-10) ranked by predicted impact.
- Full copy organized by section with clear headers.
- CTA variations (3-5) with reasoning for each.
- Tone check - Confirm the tone matches the brief.
- Readability score - Estimate Flesch-Kincaid grade level.
- Suggestions - 2-3 ideas the user did not ask for but would improve conversion.
Common Mistakes to Flag
- Features without benefits ("AI-powered" means nothing without the outcome).
- Talking about the company instead of the reader.
- Weak, generic CTAs ("Learn More", "Submit", "Click Here").
- No social proof anywhere on the page.
- Burying the CTA below the fold with no early CTA.
- Using jargon the target audience does not understand.
- Making claims without proof (testimonials, data, case studies).
04 同仓库更多 Skills
vitest-test-conventions
ACTIVATE when writing Vitest tests, creating test files, using vi.fn()/vi.mock()/vi.spyOn(), or test factories. ACTIVATE for 'Vitest', 'it.each', 'NestJS testing module', 'supertest', 'vi.fn', 'vi.mock', 'spyOn'. Provides Vitest/NestJS-specific testing patterns; cross-language testing principles (DAMP, AAA, spy over mock, what NOT to test) live in craft:testing-principles. DO NOT use for: node:test files (a file importing node:test) or a project whose tests run under node --test (see node-test:node-test-conventions), TDD workflow/iterations (see vitest:vitest-tdd-workflow), PHP/PHPUnit tests (see phpunit:php-test-conventions).
vitest-tdd-workflow
ACTIVATE when building new features, endpoints, or user stories using TDD with Vitest in a TypeScript/NestJS context. ACTIVATE for '/feature-tdd-dev', 'TDD', 'red-green-refactor' in TS context. Provides Vitest/NestJS-specific TDD examples and commands; cross-language TDD workflow (cross-layer iterations, RED-GREEN-REFACTOR, working app, bug-fix-first-test, mocks-hiding-bugs) lives in craft:tdd-workflow-principles. DO NOT use for: node:test files (a file importing node:test) or a project whose tests run under node --test (see node-test:node-test-conventions), test writing conventions (see vitest:vitest-test-conventions), PHP TDD (see phpunit:php-tdd-workflow).
ts-refactoring
ACTIVATE when refactoring TypeScript code. ACTIVATE for 'refactor', 'extract', 'redesign', 'simplify', or 'clean up' in a TypeScript / Node / NestJS context. This skill provides TS-specific examples for the cross-language refactoring rules defined in craft:refactoring-principles. DO NOT use for: writing new features from scratch, general OOP patterns (see ts-oop).
ts-ports-adapters
ACTIVATE when a TypeScript codebase with no dependency-injection container has to declare a port and wire its adapter — a repository, a clock, an id generator, an event dispatcher the domain depends on. ACTIVATE for 'port', 'adapter', 'SPI', 'dependency inversion' or 'composition root' in a codebase that wires its dependencies by hand. Covers: the port as a type of functions in the domain layer, the adapter as an object literal annotated with it, the handler that takes its dependencies first and its data second, the composition root in the infrastructure layer, and the in-memory stub that substitutes for the adapter in a unit test. DO NOT use for: NestJS, or any container-based DI with decorators and tokens (see nest-ddd-conventions), aggregate operations and smart constructors (see ddd-ts-fp), the Result type itself (see ts-functional).
ts-oop
ACTIVATE when designing TypeScript classes, and the value objects or collections modelled as classes, or when the user asks about object design, encapsulation, Tell Don't Ask, or Symbol.iterator. Provides TS-specific examples for the cross-language OOP rules defined in craft:oop-principles, plus TS-specific patterns (Symbol.iterator, branded types for primitive identifiers). DO NOT use for: a value object or an aggregate modelled as an immutable record rather than a class (see ddd-ts-fp), refactoring methodology (see ts-refactoring).
ts-layer-boundaries
ACTIVATE when wiring a Worker entry point, a Router, a controller, or a domain event consumer in a TypeScript CQRS codebase, or when deciding where a port belongs. ACTIVATE for 'composition root', 'layer boundary', 'ESLint zones', 'domain must not import infrastructure'. Covers: the *Worker.ts composition root, the curried consumer, Router wiring of command endpoints, the five-gesture controller, the domain-to-infrastructure import boundary enforced by ESLint, infrastructure-only ports, in-memory doubles for every port, the read-can-reach-write asymmetry, and read endpoints going through a domain handler. DO NOT use for: the port's own shape and adapter binding (see ts-ports-adapters), the Result type (see ts-functional), domain event structure (see ts-ddd-events).