bobo-ai-cli 3.0.3 → 3.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (238) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +259 -259
  3. package/bundled-skills/CORE_SKILLS.txt +18 -18
  4. package/bundled-skills/backend-expert/SKILL.md +97 -97
  5. package/bundled-skills/code-review/SKILL.md +280 -280
  6. package/bundled-skills/code-review-expert/SKILL.md +85 -85
  7. package/bundled-skills/context-budget-analyzer/SKILL.md +76 -76
  8. package/bundled-skills/context-compressor/SKILL.md +75 -75
  9. package/bundled-skills/context-optimization-suite/SKILL.md +162 -162
  10. package/bundled-skills/frontend-expert/SKILL.md +93 -93
  11. package/bundled-skills/github/SKILL.md +12 -12
  12. package/bundled-skills/high-agency/SKILL.md +473 -473
  13. package/bundled-skills/high-agency/references/builder-patterns.md +126 -126
  14. package/bundled-skills/high-agency/references/recovery-playbook.md +298 -298
  15. package/bundled-skills/memory-manager/SKILL.md +214 -214
  16. package/bundled-skills/memory-manager/references/advanced-config.md +65 -65
  17. package/bundled-skills/orchestrator/SKILL.md +681 -681
  18. package/bundled-skills/planning-with-files/SKILL.md +193 -193
  19. package/bundled-skills/skill-creator/SKILL.md +220 -220
  20. package/bundled-skills/testing-expert/SKILL.md +99 -99
  21. package/bundled-skills/verify/SKILL.md +15 -15
  22. package/dist/agent.d.ts +5 -0
  23. package/dist/agent.js +11 -1
  24. package/dist/agent.js.map +1 -1
  25. package/dist/agents/catalog.d.ts +47 -0
  26. package/dist/agents/catalog.js +63 -5
  27. package/dist/agents/catalog.js.map +1 -1
  28. package/dist/agents/router.d.ts +12 -1
  29. package/dist/agents/router.js +43 -3
  30. package/dist/agents/router.js.map +1 -1
  31. package/dist/agents/spawn.js +36 -18
  32. package/dist/agents/spawn.js.map +1 -1
  33. package/dist/autonomous.js +5 -5
  34. package/dist/cli.js +23 -21
  35. package/dist/cli.js.map +1 -1
  36. package/dist/compactor.js +39 -39
  37. package/dist/dream.js +29 -29
  38. package/dist/image-input.d.ts +44 -0
  39. package/dist/image-input.js +161 -0
  40. package/dist/image-input.js.map +1 -0
  41. package/dist/memory.js +13 -13
  42. package/dist/project.js +15 -15
  43. package/dist/repl.js +88 -0
  44. package/dist/repl.js.map +1 -1
  45. package/dist/skills.js +54 -54
  46. package/dist/sub-agents.js +65 -65
  47. package/dist/tools/browser.js +21 -21
  48. package/dist/tools/claude-code.js +10 -10
  49. package/dist/web.js +7 -7
  50. package/dist/wiki-commands.d.ts +2 -0
  51. package/dist/wiki-commands.js +249 -0
  52. package/dist/wiki-commands.js.map +1 -0
  53. package/dist/wiki.d.ts +90 -0
  54. package/dist/wiki.js +614 -0
  55. package/dist/wiki.js.map +1 -0
  56. package/knowledge/advanced-patterns.md +70 -70
  57. package/knowledge/agent-directives.md +74 -74
  58. package/knowledge/api-integration-patterns.md +102 -0
  59. package/knowledge/code-review-protocol.md +69 -0
  60. package/knowledge/dream.md +36 -36
  61. package/knowledge/engineering.md +52 -46
  62. package/knowledge/error-catalog.md +38 -33
  63. package/knowledge/event-driven-architecture.md +43 -0
  64. package/knowledge/external-alignment.md +47 -0
  65. package/knowledge/high-agency.md +73 -0
  66. package/knowledge/image-generation.md +48 -0
  67. package/knowledge/index.json +194 -169
  68. package/knowledge/llm-wiki-pattern.md +71 -0
  69. package/knowledge/long-task-management.md +79 -0
  70. package/knowledge/memory/cache-optimization-and-skill-integration.md +102 -102
  71. package/knowledge/memory/engineering-patterns.md +134 -134
  72. package/knowledge/memory/feedback_root_structure.md +15 -15
  73. package/knowledge/memory/project-contexts.md +69 -69
  74. package/knowledge/memory/tools-and-services.md +85 -85
  75. package/knowledge/memory-management.md +72 -0
  76. package/knowledge/rules/advisor-strategy.md +204 -0
  77. package/knowledge/rules/agents.md +62 -62
  78. package/knowledge/rules/blocking-rules.md +323 -323
  79. package/knowledge/rules/cache-management.md +379 -379
  80. package/knowledge/rules/capability-evolution.md +132 -132
  81. package/knowledge/rules/coding.md +126 -126
  82. package/knowledge/rules/engineering-workflows.md +225 -225
  83. package/knowledge/rules/evomap-content-guidelines.md +354 -354
  84. package/knowledge/rules/evomap-guide.md +224 -224
  85. package/knowledge/rules/external-alignment.md +22 -0
  86. package/knowledge/rules/git.md +31 -31
  87. package/knowledge/rules/hooks.md +106 -106
  88. package/knowledge/rules/performance.md +101 -101
  89. package/knowledge/rules/remotion-auto-production.md +1120 -1120
  90. package/knowledge/rules/security.md +46 -46
  91. package/knowledge/rules/testing.md +32 -32
  92. package/knowledge/rules/work-mode.md +208 -208
  93. package/knowledge/rules.md +62 -62
  94. package/knowledge/self-evolution.md +78 -0
  95. package/knowledge/self-rationalization-guard.md +52 -0
  96. package/knowledge/skills/Skill_Seekers.md +1722 -1722
  97. package/knowledge/skills/ab-test-setup.md +557 -557
  98. package/knowledge/skills/agent-sdk-dev.md +238 -238
  99. package/knowledge/skills/agent-tools.md +136 -136
  100. package/knowledge/skills/analytics-tracking.md +597 -597
  101. package/knowledge/skills/artifacts-builder.md +89 -89
  102. package/knowledge/skills/asana.md +12 -12
  103. package/knowledge/skills/backend-expert.md +97 -97
  104. package/knowledge/skills/brand-voice.md +481 -481
  105. package/knowledge/skills/browser-use.md +419 -419
  106. package/knowledge/skills/cache-optimization-skill.md +179 -179
  107. package/knowledge/skills/canvas-design.md +147 -147
  108. package/knowledge/skills/citation-validator.md +203 -203
  109. package/knowledge/skills/clangd-lsp.md +52 -52
  110. package/knowledge/skills/code-review-expert.md +85 -85
  111. package/knowledge/skills/code-review.md +280 -280
  112. package/knowledge/skills/code-simplifier.md +12 -12
  113. package/knowledge/skills/commit-commands.md +258 -258
  114. package/knowledge/skills/competitor-alternatives.md +795 -795
  115. package/knowledge/skills/content-atomizer.md +910 -910
  116. package/knowledge/skills/content-research-writer.md +605 -605
  117. package/knowledge/skills/context-optimization-suite.md +162 -162
  118. package/knowledge/skills/context7.md +12 -12
  119. package/knowledge/skills/copy-editing.md +494 -494
  120. package/knowledge/skills/copywriting.md +510 -510
  121. package/knowledge/skills/csharp-lsp.md +40 -40
  122. package/knowledge/skills/decision-making-framework.md +154 -154
  123. package/knowledge/skills/developer-growth-analysis.md +335 -335
  124. package/knowledge/skills/direct-response-copy.md +2336 -2336
  125. package/knowledge/skills/docker-expert.md +229 -229
  126. package/knowledge/skills/document-skills.md +12 -12
  127. package/knowledge/skills/documentation-expert.md +126 -126
  128. package/knowledge/skills/email-sequence.md +1061 -1061
  129. package/knowledge/skills/email-sequences.md +910 -910
  130. package/knowledge/skills/example-plugin.md +72 -72
  131. package/knowledge/skills/explanatory-output-style.md +82 -82
  132. package/knowledge/skills/feature-dev.md +458 -458
  133. package/knowledge/skills/file-organizer.md +466 -466
  134. package/knowledge/skills/firebase.disabled.md +12 -12
  135. package/knowledge/skills/form-cro.md +488 -488
  136. package/knowledge/skills/free-tool-strategy.md +636 -636
  137. package/knowledge/skills/frontend-design-offical.md +55 -55
  138. package/knowledge/skills/frontend-design.md +41 -41
  139. package/knowledge/skills/frontend-expert.md +93 -93
  140. package/knowledge/skills/github.md +12 -12
  141. package/knowledge/skills/gitlab.md +12 -12
  142. package/knowledge/skills/gopls-lsp.md +32 -32
  143. package/knowledge/skills/got-controller.md +218 -218
  144. package/knowledge/skills/greptile.md +72 -72
  145. package/knowledge/skills/hookify.md +376 -376
  146. package/knowledge/skills/image-editor.md +189 -189
  147. package/knowledge/skills/image-enhancer.md +109 -109
  148. package/knowledge/skills/jdtls-lsp.md +49 -49
  149. package/knowledge/skills/json-canvas.md +654 -654
  150. package/knowledge/skills/keyword-research.md +559 -559
  151. package/knowledge/skills/kotlin-lsp.md +28 -28
  152. package/knowledge/skills/laravel-boost.md +12 -12
  153. package/knowledge/skills/launch-strategy.md +394 -394
  154. package/knowledge/skills/lead-magnet.md +393 -393
  155. package/knowledge/skills/learning-output-style.md +106 -106
  156. package/knowledge/skills/linear.md +12 -12
  157. package/knowledge/skills/lua-lsp.md +47 -47
  158. package/knowledge/skills/marketing-ideas.md +720 -720
  159. package/knowledge/skills/marketing-psychology.md +534 -534
  160. package/knowledge/skills/mcp-builder.md +369 -369
  161. package/knowledge/skills/meeting-insights-analyzer.md +347 -347
  162. package/knowledge/skills/memory-evolution-system.md +172 -172
  163. package/knowledge/skills/multi-lens-thinking.md +407 -407
  164. package/knowledge/skills/nano-banana-pro.md +116 -116
  165. package/knowledge/skills/newsletter.md +736 -736
  166. package/knowledge/skills/notebooklm.md +296 -296
  167. package/knowledge/skills/obsidian-bases.md +634 -634
  168. package/knowledge/skills/obsidian-markdown.md +651 -651
  169. package/knowledge/skills/onboarding-cro.md +494 -494
  170. package/knowledge/skills/orchestrator.md +681 -681
  171. package/knowledge/skills/page-cro.md +379 -379
  172. package/knowledge/skills/paid-ads.md +624 -624
  173. package/knowledge/skills/paywall-upgrade-cro.md +651 -651
  174. package/knowledge/skills/php-lsp.md +36 -36
  175. package/knowledge/skills/planning-with-files.md +193 -193
  176. package/knowledge/skills/playwright.md +12 -12
  177. package/knowledge/skills/plugin-dev.md +434 -434
  178. package/knowledge/skills/popup-cro.md +520 -520
  179. package/knowledge/skills/positioning-angles.md +330 -330
  180. package/knowledge/skills/pr-review-toolkit.md +359 -359
  181. package/knowledge/skills/pricing-strategy.md +777 -777
  182. package/knowledge/skills/programmatic-seo.md +714 -714
  183. package/knowledge/skills/pyright-lsp.md +43 -43
  184. package/knowledge/skills/quality-assurance-framework.md +168 -168
  185. package/knowledge/skills/question-refiner.md +160 -160
  186. package/knowledge/skills/ralph-loop.md +205 -205
  187. package/knowledge/skills/refactoring-expert.md +103 -103
  188. package/knowledge/skills/referral-program.md +668 -668
  189. package/knowledge/skills/research-executor.md +164 -164
  190. package/knowledge/skills/review-with-security.md +12 -12
  191. package/knowledge/skills/rust-analyzer-lsp.md +50 -50
  192. package/knowledge/skills/schema-markup.md +647 -647
  193. package/knowledge/skills/security-audit-expert.md +124 -124
  194. package/knowledge/skills/security-expert.md +140 -140
  195. package/knowledge/skills/security-guidance.md +12 -12
  196. package/knowledge/skills/seedance-prompt.md +139 -139
  197. package/knowledge/skills/self-evolution.md +1160 -1160
  198. package/knowledge/skills/seo-audit.md +432 -432
  199. package/knowledge/skills/seo-content.md +787 -787
  200. package/knowledge/skills/serena.md +12 -12
  201. package/knowledge/skills/signup-flow-cro.md +409 -409
  202. package/knowledge/skills/skill-creator.md +220 -220
  203. package/knowledge/skills/skill-manager.md +226 -226
  204. package/knowledge/skills/skill-share.md +98 -98
  205. package/knowledge/skills/slack.md +12 -12
  206. package/knowledge/skills/social-content.md +878 -878
  207. package/knowledge/skills/spec-flow-skill.md +124 -124
  208. package/knowledge/skills/stripe.md +12 -12
  209. package/knowledge/skills/supabase.md +12 -12
  210. package/knowledge/skills/swift-lsp.md +40 -40
  211. package/knowledge/skills/synthesizer.md +236 -236
  212. package/knowledge/skills/template-skill.md +16 -16
  213. package/knowledge/skills/testing-expert.md +99 -99
  214. package/knowledge/skills/theme-factory.md +72 -72
  215. package/knowledge/skills/tiktok-research.md +208 -208
  216. package/knowledge/skills/typescript-lsp.md +36 -36
  217. package/knowledge/skills/ui-ux-pro-max.md +247 -247
  218. package/knowledge/skills/verify.md +15 -15
  219. package/knowledge/skills/visual-prompt-engineer.md +102 -102
  220. package/knowledge/skills/webapp-testing.md +111 -111
  221. package/knowledge/skills/wide-research.md +191 -191
  222. package/knowledge/system.md +93 -93
  223. package/knowledge/task-router.md +46 -37
  224. package/knowledge/verification.md +38 -38
  225. package/knowledge/worker-prompt-craft.md +66 -0
  226. package/knowledge/workflows/3d-viz.md +47 -47
  227. package/knowledge/workflows/data-pipeline.md +47 -47
  228. package/knowledge/workflows/db-migration.md +51 -51
  229. package/knowledge/workflows/feature-dev.md +41 -41
  230. package/knowledge/workflows/tdd-flow.md +52 -52
  231. package/knowledge/workflows/ui-verify.md +51 -51
  232. package/package.json +74 -74
  233. package/dist/claude-bridge.d.ts +0 -18
  234. package/dist/claude-bridge.js +0 -91
  235. package/dist/claude-bridge.js.map +0 -1
  236. package/dist/tools/claude-bridge-tool.d.ts +0 -4
  237. package/dist/tools/claude-bridge-tool.js +0 -44
  238. package/dist/tools/claude-bridge-tool.js.map +0 -1
@@ -1,510 +1,510 @@
1
- ---
2
- id: "copywriting"
3
- title: "Copywriting"
4
- category: "marketing"
5
- tags: ["copywriting", "before writing", "copywriting principles", "writing style rules", "best practices", "page structure framework", "landing page section variety", "cta copy guidelines", "output format", "page-specific guidance"]
6
- triggers: []
7
- dependencies: []
8
- source: "E:/Bobo's Coding cache/.claude/skills/copywriting"
9
- ---
10
-
11
- ---
12
- name: copywriting
13
- 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.
14
- ---
15
-
16
- # Copywriting
17
-
18
- You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action.
19
-
20
- ## Before Writing
21
-
22
- Gather this context (ask if not provided):
23
-
24
- ### 1. Page Purpose
25
-
26
- - What type of page is this? (homepage, landing page, pricing, feature, about)
27
- - What is the ONE primary action you want visitors to take?
28
- - What's the secondary action (if any)?
29
-
30
- ### 2. Audience
31
-
32
- - Who is the ideal customer for this page?
33
- - What problem are they trying to solve?
34
- - What have they already tried?
35
- - What objections or hesitations do they have?
36
- - What language do they use to describe their problem?
37
-
38
- ### 3. Product/Offer
39
-
40
- - What are you selling or offering?
41
- - What makes it different from alternatives?
42
- - What's the key transformation or outcome?
43
- - Any proof points (numbers, testimonials, case studies)?
44
-
45
- ### 4. Context
46
-
47
- - Where is traffic coming from? (ads, organic, email)
48
- - What do visitors already know before arriving?
49
- - What messaging are they seeing before this page?
50
-
51
- ---
52
-
53
- ## Copywriting Principles
54
-
55
- ### Clarity Over Cleverness
56
-
57
- - If you have to choose between clear and creative, choose clear
58
- - Every sentence should have one job
59
- - Remove words that don't add meaning
60
-
61
- ### Benefits Over Features
62
-
63
- - Features: What it does
64
- - Benefits: What that means for the customer
65
- - Always connect features to outcomes
66
-
67
- ### Specificity Over Vagueness
68
-
69
- - Vague: "Save time on your workflow"
70
- - Specific: "Cut your weekly reporting from 4 hours to 15 minutes"
71
-
72
- ### Customer Language Over Company Language
73
-
74
- - Use words your customers use
75
- - Avoid jargon unless your audience uses it
76
- - Mirror voice-of-customer from reviews, interviews, support tickets
77
-
78
- ### One Idea Per Section
79
-
80
- - Don't try to say everything everywhere
81
- - Each section should advance one argument
82
- - Build a logical flow down the page
83
-
84
- ---
85
-
86
- ## Writing Style Rules
87
-
88
- Follow these core principles. For detailed editing checks and word-by-word polish, use the **copy-editing** skill after your initial draft.
89
-
90
- ### Core Style Principles
91
-
92
- 1. **Simple over complex** — Use everyday words. "Use" instead of "utilize," "help" instead of "facilitate."
93
-
94
- 2. **Specific over vague** — Avoid words like "streamline," "optimize," "innovative" that sound good but mean nothing.
95
-
96
- 3. **Active over passive** — "We generate reports" not "Reports are generated."
97
-
98
- 4. **Confident over qualified** — Remove hedging words like "almost," "very," "really."
99
-
100
- 5. **Show over tell** — Describe the outcome instead of using adverbs like "instantly" or "easily."
101
-
102
- 6. **Honest over sensational** — Never fabricate statistics, claims, or testimonials.
103
-
104
- ### Quick Quality Check
105
-
106
- Before finalizing, scan for:
107
-
108
- - Jargon that could confuse outsiders
109
- - Sentences trying to do too much (max 3 conjunctions)
110
- - Passive voice constructions
111
- - Exclamation points (remove them)
112
- - Marketing buzzwords without substance
113
-
114
- For a thorough line-by-line review, run the copy through the **copy-editing** skill's Seven Sweeps framework.
115
-
116
- ---
117
-
118
- ## Best Practices
119
-
120
- ### Be Direct
121
-
122
- Get to the point. Don't bury the value in qualifications.
123
-
124
- ❌ Slack lets you share files instantly, from documents to images, directly in your conversations
125
-
126
- ✅ Need to share a screenshot? Send as many documents, images, and audio files as your heart desires.
127
-
128
- ### Use Rhetorical Questions
129
-
130
- Questions engage readers and make them think about their own situation.
131
-
132
- ✅ Hate returning stuff to Amazon?
133
-
134
- ✅ Need to share a screenshot?
135
-
136
- ✅ Tired of chasing approvals?
137
-
138
- ### Use Analogies and Metaphors
139
-
140
- When appropriate, analogies make abstract concepts concrete and memorable.
141
-
142
- ❌ Slack lets you share files instantly, from documents to images, directly in your conversations
143
-
144
- ✅ Imagine Slack's file-sharing as a digital whiteboard where everyone can post files, images, and updates in real time.
145
-
146
- ### Pepper in Humor (When Appropriate)
147
-
148
- Puns, wit, and humor make copy memorable—but only if it fits the brand and doesn't undermine clarity.
149
-
150
- ---
151
-
152
- ## Page Structure Framework
153
-
154
- ### Above the Fold (First Screen)
155
-
156
- **Headline**
157
-
158
- - Your single most important message
159
- - Should communicate core value proposition
160
- - Specific > generic
161
-
162
- **Headline Formulas:**
163
-
164
- **{Achieve desirable outcome} without {pain point}**
165
- _Example: Understand how users are really experiencing your site without drowning in numbers_
166
-
167
- **The {opposite of usual process} way to {achieve desirable outcome}**
168
- _Example: The easiest way to turn your passion into income_
169
-
170
- **Never {unpleasant event} again**
171
- _Example: Never miss a sales opportunity again_
172
-
173
- **{Key feature/product type} for {target audience}**
174
- _Example: Advanced analytics for Shopify e-commerce_
175
-
176
- **{Key feature/product type} for {target audience} to {what it's used for}**
177
- _Example: An online whiteboard for teams to ideate and brainstorm together_
178
-
179
- **You don't have to {skills or resources} to {achieve desirable outcome}**
180
- _Example: With Ahrefs, you don't have to be an SEO pro to rank higher and get more traffic_
181
-
182
- **{Achieve desirable outcome} by {how product makes it possible}**
183
- _Example: Generate more leads by seeing which companies visit your site_
184
-
185
- **{Key benefit of your product}**
186
- _Example: Sound clear in online meetings_
187
-
188
- **{Question highlighting the main pain point}**
189
- _Example: Hate returning stuff to Amazon?_
190
-
191
- **Turn {input} into {outcome}**
192
- _Example: Turn your hard-earned sales into repeat customers_
193
-
194
- **Additional formulas:**
195
-
196
- - "[Achieve outcome] in [timeframe]"
197
- - "The [category] that [key differentiator]"
198
- - "Stop [pain]. Start [pleasure]."
199
- - "[Number] [people] use [product] to [outcome]"
200
-
201
- **Subheadline**
202
-
203
- - Expands on the headline
204
- - Adds specificity or addresses secondary concern
205
- - 1-2 sentences max
206
-
207
- **Primary CTA**
208
-
209
- - Action-oriented button text
210
- - Communicate what they get, not what they do
211
- - "Start Free Trial" > "Sign Up"
212
- - "Get Your Report" > "Submit"
213
-
214
- **Supporting Visual**
215
-
216
- - Product screenshot, demo, or hero image
217
- - Should reinforce the message, not distract
218
-
219
- ### Social Proof Section
220
-
221
- Options (use 1-2):
222
-
223
- - Customer logos (recognizable > many)
224
- - Key metric ("10,000+ teams")
225
- - Short testimonial with attribution
226
- - Star rating with review count
227
-
228
- ### Problem/Pain Section
229
-
230
- - Articulate the problem better than they can
231
- - Show you understand their situation
232
- - Create recognition ("that's exactly my problem")
233
-
234
- Structure:
235
-
236
- - "You know the feeling..." or "If you're like most [role]..."
237
- - Describe the specific frustrations
238
- - Hint at the cost of not solving it
239
-
240
- ### Solution/Benefits Section
241
-
242
- - Bridge from problem to your solution
243
- - Focus on 3-5 key benefits (not 10)
244
- - Each benefit: headline + short explanation + proof point if available
245
-
246
- Format options:
247
-
248
- - Benefit blocks with icons
249
- - Before/after comparison
250
- - Feature → Benefit → Proof structure
251
-
252
- ### How It Works Section
253
-
254
- - Reduce perceived complexity
255
- - 3-4 step process
256
- - Each step: simple action + outcome
257
-
258
- Example:
259
-
260
- 1. "Connect your tools (2 minutes)"
261
- 2. "Set your preferences"
262
- 3. "Get automated reports every Monday"
263
-
264
- ### Social Proof (Detailed)
265
-
266
- - Full testimonials with:
267
- - Specific results
268
- - Customer name, role, company
269
- - Photo if possible
270
- - Case study snippets
271
- - Logos section (if not above)
272
-
273
- ### Objection Handling
274
-
275
- Common objections to address:
276
-
277
- - "Is this right for my situation?"
278
- - "What if it doesn't work?"
279
- - "Is it hard to set up?"
280
- - "How is this different from X?"
281
-
282
- Formats:
283
-
284
- - FAQ section
285
- - Comparison table
286
- - Guarantee/promise section
287
- - "Built for [specific audience]" section
288
-
289
- ### Final CTA Section
290
-
291
- - Recap the value proposition
292
- - Repeat the primary CTA
293
- - Add urgency if genuine (deadline, limited availability)
294
- - Risk reversal (guarantee, free trial, no credit card)
295
-
296
- ---
297
-
298
- ## Landing Page Section Variety
299
-
300
- 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:
301
-
302
- ### Section Types to Include
303
-
304
- **How It Works (Numbered Steps)**
305
- Walk users through the process in 3-4 clear steps. Reduces perceived complexity and shows the path to value.
306
-
307
- **Alternative/Competitor Comparison**
308
- Show how you stack up against the status quo or competitors. Tables, side-by-side comparisons, or "Unlike X, we..." sections.
309
-
310
- **Founder Manifesto / Our Story**
311
- Share why you built this and what you believe. Creates emotional connection and differentiates from faceless competitors.
312
-
313
- **Testimonials**
314
- Customer quotes with names, photos, and specific results. Multiple formats: quote cards, video testimonials, tweet embeds.
315
-
316
- **Case Studies**
317
- Deeper stories of customer success. Problem → Solution → Results format with specific metrics.
318
-
319
- **Use Cases**
320
- Show different ways the product is used. Helps visitors self-identify: "This is for people like me."
321
-
322
- **Personas / "Built For" Sections**
323
- Explicitly call out who the product is for: "Perfect for marketers," "Built for agencies," etc.
324
-
325
- **Stats and Social Proof**
326
- Key metrics that build credibility: "10,000+ customers," "4.9/5 rating," "$2M saved for customers."
327
-
328
- **Demo / Product Tour**
329
- Interactive demos, video walkthroughs, or GIF previews showing the product in action.
330
-
331
- **FAQ Section**
332
- Address common objections and questions. Good for SEO and reducing support burden.
333
-
334
- **Integrations / Partners**
335
- Show what tools you connect with. Logos build credibility and answer "Will this work with my stack?"
336
-
337
- **Pricing Preview**
338
- Even on non-pricing pages, a pricing teaser can move decision-makers forward.
339
-
340
- **Guarantee / Risk Reversal**
341
- Money-back guarantee, free trial terms, or "cancel anytime" messaging reduces friction.
342
-
343
- ### Recommended Section Mix
344
-
345
- For a landing page, aim for variety. Don't just stack features:
346
-
347
- **Typical Feature-Heavy Page (Weak):**
348
-
349
- 1. Hero
350
- 2. Feature 1
351
- 3. Feature 2
352
- 4. Feature 3
353
- 5. Feature 4
354
- 6. CTA
355
-
356
- **Varied, Engaging Page (Strong):**
357
-
358
- 1. Hero with clear value prop
359
- 2. Social proof bar (logos or stats)
360
- 3. Problem/pain section
361
- 4. How it works (3 steps)
362
- 5. Key benefits (2-3, not 10)
363
- 6. Testimonial
364
- 7. Use cases or personas
365
- 8. Comparison to alternatives
366
- 9. Case study snippet
367
- 10. FAQ
368
- 11. Final CTA with guarantee
369
-
370
- ---
371
-
372
- ## CTA Copy Guidelines
373
-
374
- **Weak CTAs (avoid):**
375
-
376
- - Submit
377
- - Sign Up
378
- - Learn More
379
- - Click Here
380
- - Get Started
381
-
382
- **Strong CTAs (use):**
383
-
384
- - Start Free Trial
385
- - Get [Specific Thing]
386
- - See [Product] in Action
387
- - Create Your First [Thing]
388
- - Book My Demo
389
- - Download the Guide
390
- - Try It Free
391
-
392
- **CTA formula:**
393
- [Action Verb] + [What They Get] + [Qualifier if needed]
394
-
395
- Examples:
396
-
397
- - "Start My Free Trial"
398
- - "Get the Complete Checklist"
399
- - "See Pricing for My Team"
400
-
401
- ---
402
-
403
- ## Output Format
404
-
405
- When writing copy, provide:
406
-
407
- ### Page Copy
408
-
409
- Organized by section with clear labels:
410
-
411
- - Headline
412
- - Subheadline
413
- - CTA
414
- - Section headers
415
- - Body copy
416
- - Secondary CTAs
417
-
418
- ### Annotations
419
-
420
- For key elements, explain:
421
-
422
- - Why you made this choice
423
- - What principle it applies
424
- - Alternatives considered
425
-
426
- ### Alternatives
427
-
428
- For headlines and CTAs, provide 2-3 options:
429
-
430
- - Option A: [copy] — [rationale]
431
- - Option B: [copy] — [rationale]
432
- - Option C: [copy] — [rationale]
433
-
434
- ### Meta Content (if relevant)
435
-
436
- - Page title (for SEO)
437
- - Meta description
438
-
439
- ---
440
-
441
- ## Page-Specific Guidance
442
-
443
- ### Homepage Copy
444
-
445
- - Serve multiple audiences without being generic
446
- - Lead with broadest value proposition
447
- - Provide clear paths for different visitor intents
448
- - Balance "ready to buy" and "still researching"
449
-
450
- ### Landing Page Copy
451
-
452
- - Single message, single CTA
453
- - Match headline to ad/traffic source
454
- - Complete argument on one page
455
- - Remove distractions (often no nav)
456
-
457
- ### Pricing Page Copy
458
-
459
- - Help visitors choose the right plan
460
- - Clarify what's included at each level
461
- - Address "which is right for me?" anxiety
462
- - Make recommended plan obvious
463
-
464
- ### Feature Page Copy
465
-
466
- - Connect feature to benefit to outcome
467
- - Show use cases and examples
468
- - Differentiate from competitors' versions
469
- - Clear path to try or buy
470
-
471
- ### About Page Copy
472
-
473
- - Tell the story of why you exist
474
- - Connect company mission to customer benefit
475
- - Build trust through transparency
476
- - Still include a CTA (it's still a marketing page)
477
-
478
- ---
479
-
480
- ## Voice and Tone Considerations
481
-
482
- Before writing, establish:
483
-
484
- **Formality level:**
485
-
486
- - Casual/conversational
487
- - Professional but friendly
488
- - Formal/enterprise
489
-
490
- **Brand personality:**
491
-
492
- - Playful or serious?
493
- - Bold or understated?
494
- - Technical or accessible?
495
-
496
- Maintain consistency throughout, but adjust intensity:
497
-
498
- - Headlines can be bolder
499
- - Body copy should be clearer
500
- - CTAs should be action-oriented
501
-
502
- ---
503
-
504
- ## Related Skills
505
-
506
- - **copy-editing**: For polishing and improving existing copy (use after writing your first draft)
507
- - **page-cro**: If the page structure/strategy needs work, not just copy
508
- - **email-sequence**: For email copywriting
509
- - **popup-cro**: For popup and modal copy
510
- - **ab-test-setup**: To test copy variations properly
1
+ ---
2
+ id: "copywriting"
3
+ title: "Copywriting"
4
+ category: "marketing"
5
+ tags: ["copywriting", "before writing", "copywriting principles", "writing style rules", "best practices", "page structure framework", "landing page section variety", "cta copy guidelines", "output format", "page-specific guidance"]
6
+ triggers: []
7
+ dependencies: []
8
+ source: "E:/Bobo's Coding cache/.claude/skills/copywriting"
9
+ ---
10
+
11
+ ---
12
+ name: copywriting
13
+ 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.
14
+ ---
15
+
16
+ # Copywriting
17
+
18
+ You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action.
19
+
20
+ ## Before Writing
21
+
22
+ Gather this context (ask if not provided):
23
+
24
+ ### 1. Page Purpose
25
+
26
+ - What type of page is this? (homepage, landing page, pricing, feature, about)
27
+ - What is the ONE primary action you want visitors to take?
28
+ - What's the secondary action (if any)?
29
+
30
+ ### 2. Audience
31
+
32
+ - Who is the ideal customer for this page?
33
+ - What problem are they trying to solve?
34
+ - What have they already tried?
35
+ - What objections or hesitations do they have?
36
+ - What language do they use to describe their problem?
37
+
38
+ ### 3. Product/Offer
39
+
40
+ - What are you selling or offering?
41
+ - What makes it different from alternatives?
42
+ - What's the key transformation or outcome?
43
+ - Any proof points (numbers, testimonials, case studies)?
44
+
45
+ ### 4. Context
46
+
47
+ - Where is traffic coming from? (ads, organic, email)
48
+ - What do visitors already know before arriving?
49
+ - What messaging are they seeing before this page?
50
+
51
+ ---
52
+
53
+ ## Copywriting Principles
54
+
55
+ ### Clarity Over Cleverness
56
+
57
+ - If you have to choose between clear and creative, choose clear
58
+ - Every sentence should have one job
59
+ - Remove words that don't add meaning
60
+
61
+ ### Benefits Over Features
62
+
63
+ - Features: What it does
64
+ - Benefits: What that means for the customer
65
+ - Always connect features to outcomes
66
+
67
+ ### Specificity Over Vagueness
68
+
69
+ - Vague: "Save time on your workflow"
70
+ - Specific: "Cut your weekly reporting from 4 hours to 15 minutes"
71
+
72
+ ### Customer Language Over Company Language
73
+
74
+ - Use words your customers use
75
+ - Avoid jargon unless your audience uses it
76
+ - Mirror voice-of-customer from reviews, interviews, support tickets
77
+
78
+ ### One Idea Per Section
79
+
80
+ - Don't try to say everything everywhere
81
+ - Each section should advance one argument
82
+ - Build a logical flow down the page
83
+
84
+ ---
85
+
86
+ ## Writing Style Rules
87
+
88
+ Follow these core principles. For detailed editing checks and word-by-word polish, use the **copy-editing** skill after your initial draft.
89
+
90
+ ### Core Style Principles
91
+
92
+ 1. **Simple over complex** — Use everyday words. "Use" instead of "utilize," "help" instead of "facilitate."
93
+
94
+ 2. **Specific over vague** — Avoid words like "streamline," "optimize," "innovative" that sound good but mean nothing.
95
+
96
+ 3. **Active over passive** — "We generate reports" not "Reports are generated."
97
+
98
+ 4. **Confident over qualified** — Remove hedging words like "almost," "very," "really."
99
+
100
+ 5. **Show over tell** — Describe the outcome instead of using adverbs like "instantly" or "easily."
101
+
102
+ 6. **Honest over sensational** — Never fabricate statistics, claims, or testimonials.
103
+
104
+ ### Quick Quality Check
105
+
106
+ Before finalizing, scan for:
107
+
108
+ - Jargon that could confuse outsiders
109
+ - Sentences trying to do too much (max 3 conjunctions)
110
+ - Passive voice constructions
111
+ - Exclamation points (remove them)
112
+ - Marketing buzzwords without substance
113
+
114
+ For a thorough line-by-line review, run the copy through the **copy-editing** skill's Seven Sweeps framework.
115
+
116
+ ---
117
+
118
+ ## Best Practices
119
+
120
+ ### Be Direct
121
+
122
+ Get to the point. Don't bury the value in qualifications.
123
+
124
+ ❌ Slack lets you share files instantly, from documents to images, directly in your conversations
125
+
126
+ ✅ Need to share a screenshot? Send as many documents, images, and audio files as your heart desires.
127
+
128
+ ### Use Rhetorical Questions
129
+
130
+ Questions engage readers and make them think about their own situation.
131
+
132
+ ✅ Hate returning stuff to Amazon?
133
+
134
+ ✅ Need to share a screenshot?
135
+
136
+ ✅ Tired of chasing approvals?
137
+
138
+ ### Use Analogies and Metaphors
139
+
140
+ When appropriate, analogies make abstract concepts concrete and memorable.
141
+
142
+ ❌ Slack lets you share files instantly, from documents to images, directly in your conversations
143
+
144
+ ✅ Imagine Slack's file-sharing as a digital whiteboard where everyone can post files, images, and updates in real time.
145
+
146
+ ### Pepper in Humor (When Appropriate)
147
+
148
+ Puns, wit, and humor make copy memorable—but only if it fits the brand and doesn't undermine clarity.
149
+
150
+ ---
151
+
152
+ ## Page Structure Framework
153
+
154
+ ### Above the Fold (First Screen)
155
+
156
+ **Headline**
157
+
158
+ - Your single most important message
159
+ - Should communicate core value proposition
160
+ - Specific > generic
161
+
162
+ **Headline Formulas:**
163
+
164
+ **{Achieve desirable outcome} without {pain point}**
165
+ _Example: Understand how users are really experiencing your site without drowning in numbers_
166
+
167
+ **The {opposite of usual process} way to {achieve desirable outcome}**
168
+ _Example: The easiest way to turn your passion into income_
169
+
170
+ **Never {unpleasant event} again**
171
+ _Example: Never miss a sales opportunity again_
172
+
173
+ **{Key feature/product type} for {target audience}**
174
+ _Example: Advanced analytics for Shopify e-commerce_
175
+
176
+ **{Key feature/product type} for {target audience} to {what it's used for}**
177
+ _Example: An online whiteboard for teams to ideate and brainstorm together_
178
+
179
+ **You don't have to {skills or resources} to {achieve desirable outcome}**
180
+ _Example: With Ahrefs, you don't have to be an SEO pro to rank higher and get more traffic_
181
+
182
+ **{Achieve desirable outcome} by {how product makes it possible}**
183
+ _Example: Generate more leads by seeing which companies visit your site_
184
+
185
+ **{Key benefit of your product}**
186
+ _Example: Sound clear in online meetings_
187
+
188
+ **{Question highlighting the main pain point}**
189
+ _Example: Hate returning stuff to Amazon?_
190
+
191
+ **Turn {input} into {outcome}**
192
+ _Example: Turn your hard-earned sales into repeat customers_
193
+
194
+ **Additional formulas:**
195
+
196
+ - "[Achieve outcome] in [timeframe]"
197
+ - "The [category] that [key differentiator]"
198
+ - "Stop [pain]. Start [pleasure]."
199
+ - "[Number] [people] use [product] to [outcome]"
200
+
201
+ **Subheadline**
202
+
203
+ - Expands on the headline
204
+ - Adds specificity or addresses secondary concern
205
+ - 1-2 sentences max
206
+
207
+ **Primary CTA**
208
+
209
+ - Action-oriented button text
210
+ - Communicate what they get, not what they do
211
+ - "Start Free Trial" > "Sign Up"
212
+ - "Get Your Report" > "Submit"
213
+
214
+ **Supporting Visual**
215
+
216
+ - Product screenshot, demo, or hero image
217
+ - Should reinforce the message, not distract
218
+
219
+ ### Social Proof Section
220
+
221
+ Options (use 1-2):
222
+
223
+ - Customer logos (recognizable > many)
224
+ - Key metric ("10,000+ teams")
225
+ - Short testimonial with attribution
226
+ - Star rating with review count
227
+
228
+ ### Problem/Pain Section
229
+
230
+ - Articulate the problem better than they can
231
+ - Show you understand their situation
232
+ - Create recognition ("that's exactly my problem")
233
+
234
+ Structure:
235
+
236
+ - "You know the feeling..." or "If you're like most [role]..."
237
+ - Describe the specific frustrations
238
+ - Hint at the cost of not solving it
239
+
240
+ ### Solution/Benefits Section
241
+
242
+ - Bridge from problem to your solution
243
+ - Focus on 3-5 key benefits (not 10)
244
+ - Each benefit: headline + short explanation + proof point if available
245
+
246
+ Format options:
247
+
248
+ - Benefit blocks with icons
249
+ - Before/after comparison
250
+ - Feature → Benefit → Proof structure
251
+
252
+ ### How It Works Section
253
+
254
+ - Reduce perceived complexity
255
+ - 3-4 step process
256
+ - Each step: simple action + outcome
257
+
258
+ Example:
259
+
260
+ 1. "Connect your tools (2 minutes)"
261
+ 2. "Set your preferences"
262
+ 3. "Get automated reports every Monday"
263
+
264
+ ### Social Proof (Detailed)
265
+
266
+ - Full testimonials with:
267
+ - Specific results
268
+ - Customer name, role, company
269
+ - Photo if possible
270
+ - Case study snippets
271
+ - Logos section (if not above)
272
+
273
+ ### Objection Handling
274
+
275
+ Common objections to address:
276
+
277
+ - "Is this right for my situation?"
278
+ - "What if it doesn't work?"
279
+ - "Is it hard to set up?"
280
+ - "How is this different from X?"
281
+
282
+ Formats:
283
+
284
+ - FAQ section
285
+ - Comparison table
286
+ - Guarantee/promise section
287
+ - "Built for [specific audience]" section
288
+
289
+ ### Final CTA Section
290
+
291
+ - Recap the value proposition
292
+ - Repeat the primary CTA
293
+ - Add urgency if genuine (deadline, limited availability)
294
+ - Risk reversal (guarantee, free trial, no credit card)
295
+
296
+ ---
297
+
298
+ ## Landing Page Section Variety
299
+
300
+ 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:
301
+
302
+ ### Section Types to Include
303
+
304
+ **How It Works (Numbered Steps)**
305
+ Walk users through the process in 3-4 clear steps. Reduces perceived complexity and shows the path to value.
306
+
307
+ **Alternative/Competitor Comparison**
308
+ Show how you stack up against the status quo or competitors. Tables, side-by-side comparisons, or "Unlike X, we..." sections.
309
+
310
+ **Founder Manifesto / Our Story**
311
+ Share why you built this and what you believe. Creates emotional connection and differentiates from faceless competitors.
312
+
313
+ **Testimonials**
314
+ Customer quotes with names, photos, and specific results. Multiple formats: quote cards, video testimonials, tweet embeds.
315
+
316
+ **Case Studies**
317
+ Deeper stories of customer success. Problem → Solution → Results format with specific metrics.
318
+
319
+ **Use Cases**
320
+ Show different ways the product is used. Helps visitors self-identify: "This is for people like me."
321
+
322
+ **Personas / "Built For" Sections**
323
+ Explicitly call out who the product is for: "Perfect for marketers," "Built for agencies," etc.
324
+
325
+ **Stats and Social Proof**
326
+ Key metrics that build credibility: "10,000+ customers," "4.9/5 rating," "$2M saved for customers."
327
+
328
+ **Demo / Product Tour**
329
+ Interactive demos, video walkthroughs, or GIF previews showing the product in action.
330
+
331
+ **FAQ Section**
332
+ Address common objections and questions. Good for SEO and reducing support burden.
333
+
334
+ **Integrations / Partners**
335
+ Show what tools you connect with. Logos build credibility and answer "Will this work with my stack?"
336
+
337
+ **Pricing Preview**
338
+ Even on non-pricing pages, a pricing teaser can move decision-makers forward.
339
+
340
+ **Guarantee / Risk Reversal**
341
+ Money-back guarantee, free trial terms, or "cancel anytime" messaging reduces friction.
342
+
343
+ ### Recommended Section Mix
344
+
345
+ For a landing page, aim for variety. Don't just stack features:
346
+
347
+ **Typical Feature-Heavy Page (Weak):**
348
+
349
+ 1. Hero
350
+ 2. Feature 1
351
+ 3. Feature 2
352
+ 4. Feature 3
353
+ 5. Feature 4
354
+ 6. CTA
355
+
356
+ **Varied, Engaging Page (Strong):**
357
+
358
+ 1. Hero with clear value prop
359
+ 2. Social proof bar (logos or stats)
360
+ 3. Problem/pain section
361
+ 4. How it works (3 steps)
362
+ 5. Key benefits (2-3, not 10)
363
+ 6. Testimonial
364
+ 7. Use cases or personas
365
+ 8. Comparison to alternatives
366
+ 9. Case study snippet
367
+ 10. FAQ
368
+ 11. Final CTA with guarantee
369
+
370
+ ---
371
+
372
+ ## CTA Copy Guidelines
373
+
374
+ **Weak CTAs (avoid):**
375
+
376
+ - Submit
377
+ - Sign Up
378
+ - Learn More
379
+ - Click Here
380
+ - Get Started
381
+
382
+ **Strong CTAs (use):**
383
+
384
+ - Start Free Trial
385
+ - Get [Specific Thing]
386
+ - See [Product] in Action
387
+ - Create Your First [Thing]
388
+ - Book My Demo
389
+ - Download the Guide
390
+ - Try It Free
391
+
392
+ **CTA formula:**
393
+ [Action Verb] + [What They Get] + [Qualifier if needed]
394
+
395
+ Examples:
396
+
397
+ - "Start My Free Trial"
398
+ - "Get the Complete Checklist"
399
+ - "See Pricing for My Team"
400
+
401
+ ---
402
+
403
+ ## Output Format
404
+
405
+ When writing copy, provide:
406
+
407
+ ### Page Copy
408
+
409
+ Organized by section with clear labels:
410
+
411
+ - Headline
412
+ - Subheadline
413
+ - CTA
414
+ - Section headers
415
+ - Body copy
416
+ - Secondary CTAs
417
+
418
+ ### Annotations
419
+
420
+ For key elements, explain:
421
+
422
+ - Why you made this choice
423
+ - What principle it applies
424
+ - Alternatives considered
425
+
426
+ ### Alternatives
427
+
428
+ For headlines and CTAs, provide 2-3 options:
429
+
430
+ - Option A: [copy] — [rationale]
431
+ - Option B: [copy] — [rationale]
432
+ - Option C: [copy] — [rationale]
433
+
434
+ ### Meta Content (if relevant)
435
+
436
+ - Page title (for SEO)
437
+ - Meta description
438
+
439
+ ---
440
+
441
+ ## Page-Specific Guidance
442
+
443
+ ### Homepage Copy
444
+
445
+ - Serve multiple audiences without being generic
446
+ - Lead with broadest value proposition
447
+ - Provide clear paths for different visitor intents
448
+ - Balance "ready to buy" and "still researching"
449
+
450
+ ### Landing Page Copy
451
+
452
+ - Single message, single CTA
453
+ - Match headline to ad/traffic source
454
+ - Complete argument on one page
455
+ - Remove distractions (often no nav)
456
+
457
+ ### Pricing Page Copy
458
+
459
+ - Help visitors choose the right plan
460
+ - Clarify what's included at each level
461
+ - Address "which is right for me?" anxiety
462
+ - Make recommended plan obvious
463
+
464
+ ### Feature Page Copy
465
+
466
+ - Connect feature to benefit to outcome
467
+ - Show use cases and examples
468
+ - Differentiate from competitors' versions
469
+ - Clear path to try or buy
470
+
471
+ ### About Page Copy
472
+
473
+ - Tell the story of why you exist
474
+ - Connect company mission to customer benefit
475
+ - Build trust through transparency
476
+ - Still include a CTA (it's still a marketing page)
477
+
478
+ ---
479
+
480
+ ## Voice and Tone Considerations
481
+
482
+ Before writing, establish:
483
+
484
+ **Formality level:**
485
+
486
+ - Casual/conversational
487
+ - Professional but friendly
488
+ - Formal/enterprise
489
+
490
+ **Brand personality:**
491
+
492
+ - Playful or serious?
493
+ - Bold or understated?
494
+ - Technical or accessible?
495
+
496
+ Maintain consistency throughout, but adjust intensity:
497
+
498
+ - Headlines can be bolder
499
+ - Body copy should be clearer
500
+ - CTAs should be action-oriented
501
+
502
+ ---
503
+
504
+ ## Related Skills
505
+
506
+ - **copy-editing**: For polishing and improving existing copy (use after writing your first draft)
507
+ - **page-cro**: If the page structure/strategy needs work, not just copy
508
+ - **email-sequence**: For email copywriting
509
+ - **popup-cro**: For popup and modal copy
510
+ - **ab-test-setup**: To test copy variations properly