Skip to content

Commit 2dc5b6b

Browse files
chore: migrate from biome to oxlint + oxfmt
1 parent 34338f0 commit 2dc5b6b

1,171 files changed

Lines changed: 18407 additions & 23093 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.agents/skills/copywriting/SKILL.md

Lines changed: 44 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,22 +16,26 @@ If `.claude/product-marketing-context.md` exists, read it before asking question
1616
Gather this context (ask if not provided):
1717

1818
### 1. Page Purpose
19+
1920
- What type of page? (homepage, landing page, pricing, feature, about)
2021
- What is the ONE primary action you want visitors to take?
2122

2223
### 2. Audience
24+
2325
- Who is the ideal customer?
2426
- What problem are they trying to solve?
2527
- What objections or hesitations do they have?
2628
- What language do they use to describe their problem?
2729

2830
### 3. Product/Offer
31+
2932
- What are you selling or offering?
3033
- What makes it different from alternatives?
3134
- What's the key transformation or outcome?
3235
- Any proof points (numbers, testimonials, case studies)?
3336

3437
### 4. Context
38+
3539
- Where is traffic coming from? (ads, organic, email)
3640
- What do visitors already know before arriving?
3741

@@ -40,19 +44,24 @@ Gather this context (ask if not provided):
4044
## Copywriting Principles
4145

4246
### Clarity Over Cleverness
47+
4348
If you have to choose between clear and creative, choose clear.
4449

4550
### Benefits Over Features
51+
4652
Features: What it does. Benefits: What that means for the customer.
4753

4854
### Specificity Over Vagueness
55+
4956
- Vague: "Save time on your workflow"
5057
- Specific: "Cut your weekly reporting from 4 hours to 15 minutes"
5158

5259
### Customer Language Over Company Language
60+
5361
Use words your customers use. Mirror voice-of-customer from reviews, interviews, support tickets.
5462

5563
### One Idea Per Section
64+
5665
Each section should advance one argument. Build a logical flow down the page.
5766

5867
---
@@ -83,21 +92,26 @@ For thorough line-by-line review, use the **copy-editing** skill after your draf
8392
## Best Practices
8493

8594
### Be Direct
95+
8696
Get to the point. Don't bury the value in qualifications.
8797

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

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

92102
### Use Rhetorical Questions
103+
93104
Questions engage readers and make them think about their own situation.
105+
94106
- "Hate returning stuff to Amazon?"
95107
- "Tired of chasing approvals?"
96108

97109
### Use Analogies When Helpful
110+
98111
Analogies make abstract concepts concrete and memorable.
99112

100113
### Pepper in Humor (When Appropriate)
114+
101115
Puns and wit make copy memorable—but only if it fits the brand and doesn't undermine clarity.
102116

103117
---
@@ -107,11 +121,13 @@ Puns and wit make copy memorable—but only if it fits the brand and doesn't und
107121
### Above the Fold
108122

109123
**Headline**
124+
110125
- Your single most important message
111126
- Communicate core value proposition
112127
- Specific > generic
113128

114129
**Example formulas:**
130+
115131
- "{Achieve outcome} without {pain point}"
116132
- "The {category} for {audience}"
117133
- "Never {unpleasant event} again"
@@ -122,24 +138,26 @@ Puns and wit make copy memorable—but only if it fits the brand and doesn't und
122138
**For natural transition phrases**: See [references/natural-transitions.md](references/natural-transitions.md)
123139

124140
**Subheadline**
141+
125142
- Expands on headline
126143
- Adds specificity
127144
- 1-2 sentences max
128145

129146
**Primary CTA**
147+
130148
- Action-oriented button text
131149
- Communicate what they get: "Start Free Trial" > "Sign Up"
132150

133151
### Core Sections
134152

135-
| Section | Purpose |
136-
|---------|---------|
137-
| Social Proof | Build credibility (logos, stats, testimonials) |
138-
| Problem/Pain | Show you understand their situation |
139-
| Solution/Benefits | Connect to outcomes (3-5 key benefits) |
140-
| How It Works | Reduce perceived complexity (3-4 steps) |
141-
| Objection Handling | FAQ, comparisons, guarantees |
142-
| Final CTA | Recap value, repeat CTA, risk reversal |
153+
| Section | Purpose |
154+
| ------------------ | ---------------------------------------------- |
155+
| Social Proof | Build credibility (logos, stats, testimonials) |
156+
| Problem/Pain | Show you understand their situation |
157+
| Solution/Benefits | Connect to outcomes (3-5 key benefits) |
158+
| How It Works | Reduce perceived complexity (3-4 steps) |
159+
| Objection Handling | FAQ, comparisons, guarantees |
160+
| Final CTA | Recap value, repeat CTA, risk reversal |
143161

144162
**For detailed section types and page templates**: See [references/copy-frameworks.md](references/copy-frameworks.md)
145163

@@ -148,9 +166,11 @@ Puns and wit make copy memorable—but only if it fits the brand and doesn't und
148166
## CTA Copy Guidelines
149167

150168
**Weak CTAs (avoid):**
169+
151170
- Submit, Sign Up, Learn More, Click Here, Get Started
152171

153172
**Strong CTAs (use):**
173+
154174
- Start Free Trial
155175
- Get [Specific Thing]
156176
- See [Product] in Action
@@ -160,6 +180,7 @@ Puns and wit make copy memorable—but only if it fits the brand and doesn't und
160180
**Formula:** [Action Verb] + [What They Get] + [Qualifier if needed]
161181

162182
Examples:
183+
163184
- "Start My Free Trial"
164185
- "Get the Complete Checklist"
165186
- "See Pricing for My Team"
@@ -169,26 +190,31 @@ Examples:
169190
## Page-Specific Guidance
170191

171192
### Homepage
193+
172194
- Serve multiple audiences without being generic
173195
- Lead with broadest value proposition
174196
- Provide clear paths for different visitor intents
175197

176198
### Landing Page
199+
177200
- Single message, single CTA
178201
- Match headline to ad/traffic source
179202
- Complete argument on one page
180203

181204
### Pricing Page
205+
182206
- Help visitors choose the right plan
183207
- Address "which is right for me?" anxiety
184208
- Make recommended plan obvious
185209

186210
### Feature Page
211+
187212
- Connect feature → benefit → outcome
188213
- Show use cases and examples
189214
- Clear path to try or buy
190215

191216
### About Page
217+
192218
- Tell the story of why you exist
193219
- Connect mission to customer benefit
194220
- Still include a CTA
@@ -200,16 +226,19 @@ Examples:
200226
Before writing, establish:
201227

202228
**Formality level:**
229+
203230
- Casual/conversational
204231
- Professional but friendly
205232
- Formal/enterprise
206233

207234
**Brand personality:**
235+
208236
- Playful or serious?
209237
- Bold or understated?
210238
- Technical or accessible?
211239

212240
Maintain consistency, but adjust intensity:
241+
213242
- Headlines can be bolder
214243
- Body copy should be clearer
215244
- CTAs should be action-oriented
@@ -221,22 +250,29 @@ Maintain consistency, but adjust intensity:
221250
When writing copy, provide:
222251

223252
### Page Copy
253+
224254
Organized by section:
255+
225256
- Headline, Subheadline, CTA
226257
- Section headers and body copy
227258
- Secondary CTAs
228259

229260
### Annotations
261+
230262
For key elements, explain:
263+
231264
- Why you made this choice
232265
- What principle it applies
233266

234267
### Alternatives
268+
235269
For headlines and CTAs, provide 2-3 options:
270+
236271
- Option A: [copy][rationale]
237272
- Option B: [copy][rationale]
238273

239274
### Meta Content (if relevant)
275+
240276
- Page title (for SEO)
241277
- Meta description
242278

0 commit comments

Comments
 (0)