From b78c2d717d3ed351c04cd5528545a75e1354df18 Mon Sep 17 00:00:00 2001 From: zlei9 Date: Sun, 29 Mar 2026 10:22:10 +0800 Subject: [PATCH] Initial commit with translated description --- SKILL.md | 89 ++++++++++++++++++++++++++++++++++ _meta.json | 6 +++ references/marketing-copy.md | 75 +++++++++++++++++++++++++++++ references/ux-patterns.md | 93 ++++++++++++++++++++++++++++++++++++ 4 files changed, 263 insertions(+) create mode 100644 SKILL.md create mode 100644 _meta.json create mode 100644 references/marketing-copy.md create mode 100644 references/ux-patterns.md diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..a8c9592 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,89 @@ +--- +name: copywriter +description: "撰写引人注目的UX文案、营销内容和产品消息。" +license: Apache-2.0 +metadata: + author: agentic-insights + version: "1.1" +--- + +# Copywriter + +Write clear, compelling copy for products, marketing, and UX. + +## Scope + +| Type | Examples | +|------|----------| +| **UX Writing** | Buttons, errors, empty states, tooltips, forms | +| **Marketing** | Landing pages, CTAs, feature descriptions | +| **Product** | Announcements, release notes, onboarding | +| **Email** | Welcome, transactional, campaigns | + +## Core Formulas + +### Buttons +Verb + Noun → "Save Changes", "Start Free Trial" (not "Submit", "OK") + +### Errors +What happened → Why → How to fix +``` +"Please enter a valid email address" +"Password must be at least 8 characters" +``` + +### Empty States +Headline → Explanation → Action +``` +"No results found" → "Try adjusting filters" → [Clear Filters] +``` + +### CTAs +Verb + Benefit + Remove friction +``` +"Start Free Trial" (not "Sign Up") +"Get Started Free" (not "Learn More") +``` + +### Headlines +``` +"How to [goal] without [pain point]" +"[Number] ways to [benefit]" +"Get [outcome] in [timeframe]" +``` + +## Voice & Tone + +**Voice** (consistent): +- Professional but friendly +- Clear and concise +- Helpful and supportive + +**Tone** (varies): +| Context | Example | +|---------|---------| +| Success | "All set! Your changes are live." | +| Error | "Something went wrong, but your data is safe." | +| Urgency | "Action required: Suspicious login detected" | + +## Power Words + +| Category | Words | +|----------|-------| +| Urgency | Now, Today, Limited, Fast | +| Value | Free, Save, Bonus, Extra | +| Trust | Guaranteed, Proven, Secure | +| Ease | Easy, Simple, Quick, Instant | + +## Checklist + +- [ ] Clear? (12-year-old test) +- [ ] Concise? (Remove unnecessary words) +- [ ] Specific? (Numbers, examples) +- [ ] Actionable? (What should user do?) +- [ ] Scannable? (Headings, bullets) + +## References + +- [UX Patterns](references/ux-patterns.md) - Buttons, errors, forms, tooltips +- [Marketing Copy](references/marketing-copy.md) - Landing pages, CTAs, emails diff --git a/_meta.json b/_meta.json new file mode 100644 index 0000000..b7cdf02 --- /dev/null +++ b/_meta.json @@ -0,0 +1,6 @@ +{ + "ownerId": "kn7c4c2km73s4wz0tk9w9a0rx580dsyx", + "slug": "copywriter", + "version": "1.1.0", + "publishedAt": 1770349618610 +} \ No newline at end of file diff --git a/references/marketing-copy.md b/references/marketing-copy.md new file mode 100644 index 0000000..e334626 --- /dev/null +++ b/references/marketing-copy.md @@ -0,0 +1,75 @@ +# Marketing Copy Patterns + +## Hero Section + +```typescript + + {/* Headline: Main benefit */} +

Deploy your app in seconds, not hours

+ + {/* Subheadline: How/Who */} +

Push your code and we'll handle deployment, scaling, monitoring.

+ + {/* CTA */} + + + + {/* Social proof */} +

Trusted by 50,000+ developers at Airbnb, Netflix, Shopify

+ +``` + +## Feature Descriptions + +Focus on benefits, not features. Be specific (numbers, timeframes). + +```typescript +const features = [ + { + title: 'Lightning-Fast Deploys', + description: 'See it live in under 30 seconds. No config files.' + }, + { + title: 'Auto-Scaling', + description: 'Handle any traffic spike. Scale from zero to millions.' + } +] +``` + +## Call-to-Action (CTA) + +| Type | Example | +|------|---------| +| Value-focused | "Start Free Trial", "Get Started Free" | +| Urgency | "Claim Your Spot", "Join 10,000 Developers" | +| Low commitment | "Browse Templates", "See How It Works" | + +Formula: Verb + Benefit + Remove friction ("Free", "No credit card") + +## Email Templates + +### Welcome Email + +```typescript + + Welcome, {name}! + Here's what to do next: +
    +
  1. Connect your Git repository
    2. +
  2. Deploy your first project (2 min)
    3. +
  3. Invite your team
    4. +
+ + +``` + +### Transactional Email + +```typescript + + Payment Successful + We've received your payment of {total}. + Order: {orderNumber} + + +``` diff --git a/references/ux-patterns.md b/references/ux-patterns.md new file mode 100644 index 0000000..bd420d5 --- /dev/null +++ b/references/ux-patterns.md @@ -0,0 +1,93 @@ +# UX Writing Patterns + +## Button Labels + +```typescript +// Bad: Vague + + + +// Good: Verb + Noun, shows outcome + + + +``` + +## Error Messages + +Formula: What happened → Why → How to fix + +```typescript +// Bad +"Invalid input" +"Error 422" + +// Good +"Please enter a valid email address" +"Password must be at least 8 characters" +``` + +## Empty States + +Formula: Headline → Explanation → Action + +```typescript +Clear Filters} +/> +``` + +## Form Labels + +```typescript + +``` + +## Loading States + +```typescript +// Bad: "Loading..." +// Good: "Creating your account..." / "Uploading (2/5)..." +``` + +## Success Messages + +```typescript +View Post} +/> +``` + +## Tooltips + +```typescript +// Bad: Repeats label + + +// Good: Adds context + +``` + +## Confirmation Dialogs + +```typescript + +``` + +## Placeholder Text + +```typescript +// Bad: "Enter value" +// Good: "e.g., john@example.com" +```