@danhachuel/thunderbolt 0.2.49 → 0.2.51

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.
@@ -0,0 +1,440 @@
1
+ ---
2
+ title: Viral Title Reference
3
+ date: 2025-12-25
4
+ version: 1.0.0
5
+ author: ice-ninja
6
+ tags: [viral, titles, headlines, CTR, psychology, formulas]
7
+ ---
8
+
9
+ # Viral Title Mastery
10
+
11
+ > ⚠️ **CRITICAL SECTION:** Titles determine 70% of content performance. This reference is mandatory reading before any title generation.
12
+
13
+ The title is the single most important element of viral content. Studies show users vote on Reddit posts without reading the linked content, click YouTube videos based solely on thumbnail+title, and scroll past articles that fail to hook in 0.3 seconds.
14
+
15
+ ---
16
+
17
+ ## Part 1: The Psychology of Viral Titles
18
+
19
+ ### Core Psychological Triggers
20
+
21
+ **1. Curiosity Gap (Information Gap Theory)**
22
+ Humans feel discomfort when there's a gap between what they know and want to know. Titles that hint at hidden knowledge without revealing everything compel clicks.
23
+
24
+ *Pattern:* "What [group] won't tell you about [topic]"
25
+ *Pattern:* "The [adjective] secret to [outcome]"
26
+ *Pattern:* "[Number] things most [people] never discover"
27
+
28
+ **2. Surprise and Novelty**
29
+ The brain releases dopamine in response to unexpected information. Breaking patterns or presenting counterintuitive claims triggers engagement.
30
+
31
+ *Pattern:* "[Common belief] is dead. Here's what's next."
32
+ *Pattern:* "Why [common practice] actually [negative outcome]"
33
+ *Pattern:* "[Contrarian claim] — and the data proves it"
34
+
35
+ **3. Loss Aversion / Fear of Missing Out (FOMO)**
36
+ Loss aversion is 2x stronger than gain anticipation. Titles implying potential loss outperform benefit-only titles.
37
+
38
+ *Pattern:* "Stop [action] before it [negative consequence]"
39
+ *Pattern:* "The [mistake] killing your [metric]"
40
+ *Pattern:* "[Year] changes you can't afford to miss"
41
+
42
+ **4. Tribal Identity**
43
+ Content that helps readers self-identify with a group creates in-group/out-group dynamics that drive engagement.
44
+
45
+ *Pattern:* "This separates [winners] from [losers]"
46
+ *Pattern:* "If you're a [identity], you need to know [fact]"
47
+ *Pattern:* "[Trait] people do [action] differently"
48
+
49
+ **5. Social Currency**
50
+ People share content that makes them look smart, informed, or ahead of the curve.
51
+
52
+ *Pattern:* "What [industry insiders] don't want you to know"
53
+ *Pattern:* "The [year] [category] playbook"
54
+ *Pattern:* "[Expert]-level tips for [common task]"
55
+
56
+ **6. Emotional Activation**
57
+ High-arousal emotions (awe, anger, anxiety, excitement) drive sharing. Low-arousal emotions (sadness, contentment) don't.
58
+
59
+ *Positive triggers:* awe, surprise, excitement, inspiration, humor
60
+ *Negative triggers:* anger, fear, anxiety, outrage, frustration
61
+
62
+ ---
63
+
64
+ ## Part 2: Title Formulas by Platform
65
+
66
+ ### Reddit Titles
67
+
68
+ **Optimal length:** 60-80 characters
69
+ **Critical window:** First hour upvote velocity determines virality
70
+
71
+ **High-performing patterns:**
72
+ ```
73
+ Hot Take: [Contrarian Position]
74
+ [Technique]: Why [Common Practice] is dead in [Year]
75
+ The [category] technique that [concrete measurable result]
76
+ Stop [old behavior]. [New behavior] is the [year] meta.
77
+ [Number] lessons from [notable experience or timeframe]
78
+ After [experience], here's what I learned about [topic]
79
+ [Specific metric] in [timeframe]: How I [achieved outcome]
80
+ ```
81
+
82
+ **Subreddit calibration:**
83
+ - r/MachineLearning: Technical, conservative claims, invite discussion
84
+ - r/ChatGPT: Practical, power-user focus, show meta-shifts
85
+ - r/singularity: Hype-tolerant, maximum viral coefficient
86
+ - r/LocalLLaMA: Self-hosting angle, cost comparisons
87
+ - Hacker News: "Show HN:" format, understate rather than overstate
88
+
89
+ **Anti-patterns (instant downvotes):**
90
+ - ❌ Excessive punctuation marks!!!
91
+ - ❌ ALL CAPS TITLES
92
+ - ❌ Direct self-promotion
93
+ - ❌ Asking for upvotes
94
+ - ❌ Generic "check this out" titles
95
+ - ❌ "What do you think?" engagement bait
96
+
97
+ ### YouTube Titles
98
+
99
+ **Optimal length:** 50-60 characters (visible without truncation)
100
+ **CTR target:** 7-15% in first 24 hours
101
+
102
+ **High-performing patterns:**
103
+ ```
104
+ [Hook phrase] — [Specific outcome or number]
105
+ I [verb] [extreme challenge] for [timeframe]
106
+ [Number] [items] that [unexpected claim]
107
+ Why [authority figure/company] [surprising action]
108
+ [This/The] is [superlative] [category]
109
+ [Verb] [topic] in [Y time] (even if [objection])
110
+ ```
111
+
112
+ **Numbers boost CTR 20-30%:**
113
+ - Odd numbers outperform even numbers
114
+ - Specific > round (37 > 40, $1,247 > $1,000)
115
+ - Include time metrics when possible ("in 48 hours")
116
+
117
+ **Power words that increase CTR:**
118
+ - Urgency: now, today, immediately, finally
119
+ - Curiosity: secret, hidden, revealed, truth
120
+ - Value: free, proven, ultimate, complete
121
+ - Fear: warning, mistake, avoid, never
122
+ - Achievement: mastered, succeeded, broke, achieved
123
+
124
+ **Front-load keywords:** First 5 words matter most for search and algorithm
125
+
126
+ ### Twitter/X Threads
127
+
128
+ **Optimal hook tweet:** Standalone viral potential
129
+ **No 1/ numbering:** Algorithmic penalty
130
+
131
+ **Thread structure:**
132
+ 1. Hook tweet (creates curiosity gap)
133
+ 2. "Here's how:" or "Thread:" indicator
134
+ 3. 3-5 mechanic tweets
135
+ 4. Payoff/result tweet
136
+ 5. Call-to-action tweet (quotable closer)
137
+
138
+ **Hook patterns:**
139
+ ```
140
+ [Opinion] is the [year] [category] that [prediction].
141
+ Most [people] [common mistake]. The [successful group] [better approach].
142
+ I spent [time] [doing thing]. [Number] takeaways:
143
+ [Counter-intuitive claim]. Thread.
144
+ The difference between [A] and [B] is [insight].
145
+ ```
146
+
147
+ ### LinkedIn
148
+
149
+ **Patterns that perform:**
150
+ - Personal story + professional lesson
151
+ - "Unpopular opinion:" framing (creates tribal split)
152
+ - Contrarian take on industry norm
153
+ - Before/after transformation
154
+ - First-person failure stories with lessons
155
+
156
+ **Avoid:**
157
+ - Third-person corporate announcements
158
+ - Hashtag-stuffed titles
159
+ - Direct "check out my product" pitches
160
+
161
+ ### Blog Post Titles (SEO-Optimized)
162
+
163
+ **Optimal length:** 50-70 characters
164
+ **Keyword placement:** First 60 characters
165
+
166
+ **High-performing patterns:**
167
+ ```
168
+ How to [Achieve X] [Without Y] [In Z Time]
169
+ [Number] [Adjective] Ways to [Achieve Outcome]
170
+ The Ultimate Guide to [Topic] for [Audience]
171
+ [Topic]: [Question Your Audience Is Asking]?
172
+ Why [Thing] Is [Unexpected Claim] (And What to Do About It)
173
+ [Number] [Topic] Mistakes You're Making (And How to Fix Them)
174
+ [Year] Guide: [Topic] for [Audience Type]
175
+ ```
176
+
177
+ **SEO requirements:**
178
+ - Primary keyword within first 5 words
179
+ - Match search intent (informational, transactional, navigational)
180
+ - Use brackets for modifiers: [2025 Guide], [Free Template]
181
+ - Question formats for featured snippet potential
182
+
183
+ ---
184
+
185
+ ## Part 3: The Title Generation Protocol
186
+
187
+ ### Step 1: Generate 20+ Variations
188
+ Don't settle for 5. Generate at minimum 20 title options using different formulas before selecting.
189
+
190
+ ### Step 2: Apply Scoring Criteria
191
+
192
+ **Curiosity Score (0-3):**
193
+ - 0: No curiosity gap
194
+ - 1: Mild interest
195
+ - 2: Strong "I need to know"
196
+ - 3: Irresistible urge to click
197
+
198
+ **Specificity Score (0-3):**
199
+ - 0: Generic, could apply to anything
200
+ - 1: Topic-specific
201
+ - 2: Includes numbers or metrics
202
+ - 3: Hyper-specific with concrete examples
203
+
204
+ **Emotional Score (0-3):**
205
+ - 0: Neutral, informational
206
+ - 1: Mild emotional activation
207
+ - 2: Clear emotional trigger
208
+ - 3: High-arousal emotion (awe, anger, surprise)
209
+
210
+ **Target: 7+ total score**
211
+
212
+ ### Step 3: Platform Calibration
213
+ Adjust winning titles for each platform's culture and constraints.
214
+
215
+ ### Step 4: A/B Testing (When Possible)
216
+ Test 2-3 variations. 10-25% CTR improvement is common from testing.
217
+
218
+ ---
219
+
220
+ ## Part 4: Title Types and Templates
221
+
222
+ ### Listicle Formulas
223
+ ```
224
+ [Number] Ways to [Achieve X] Without [Common Sacrifice]
225
+ [Number] [Adjective] Lessons from [Notable Source]
226
+ The Top [Number] [Topic] Mistakes (And How to Fix Them)
227
+ [Number] Things I Wish I Knew Before [Starting X]
228
+ [Number] [Topic] Tips That [Impressive Result]
229
+ ```
230
+
231
+ ### How-To Formulas
232
+ ```
233
+ How to [Achieve X] in [Timeframe] (Step-by-Step)
234
+ How to [Achieve X] Even If [Common Objection]
235
+ How I [Achieved X] (And How You Can Too)
236
+ How [Authority] [Achieved X] — Broken Down
237
+ The [Adjective] Way to [Common Task]
238
+ ```
239
+
240
+ ### Question Formulas
241
+ ```
242
+ Is [Common Belief] Actually [Myth/True]?
243
+ Why Doesn't [Thing] [Expected Outcome]?
244
+ What Happens When You [Action] for [Time]?
245
+ Are You Making These [Number] [Topic] Mistakes?
246
+ Can [Ordinary Thing] Really [Impressive Claim]?
247
+ ```
248
+
249
+ ### Comparison Formulas
250
+ ```
251
+ [A] vs [B]: Which [Outcome] Better?
252
+ I Tried [A] and [B] — Here's the Winner
253
+ [A] or [B]? The [Definitive/Only] Answer
254
+ Why [A] Beats [B] (Backed by Data)
255
+ [Topic]: [Option A] vs [Option B] — Full Breakdown
256
+ ```
257
+
258
+ ### Prediction/Authority Formulas
259
+ ```
260
+ [Expert] Reveals [Topic] Secrets
261
+ The [Year] [Topic] That [Prediction]
262
+ [Trend] Will [Impact] — Here's Why
263
+ [Number] [Topic] Trends for [Year] You Need to Know
264
+ What [Authority/Data] Says About [Topic]
265
+ ```
266
+
267
+ ### Contrarian Formulas
268
+ ```
269
+ [Popular Opinion] Is Wrong — Here's Why
270
+ Stop [Common Practice]: [Better Alternative]
271
+ [Controversial Claim] (Yes, Really)
272
+ Why [Successful People] Don't [Common Practice]
273
+ [Common Advice] Is Bad Advice — Do This Instead
274
+ ```
275
+
276
+ ### Problem/Solution Formulas
277
+ ```
278
+ [Common Problem]? Here's the Fix
279
+ The [Real Reason] [Problem] Keeps Happening
280
+ Why Your [Thing] Isn't Working (And What To Do)
281
+ [Problem] Solved: [Solution] in [Time]
282
+ Finally: A [Topic] That Actually [Works/Solves Problem]
283
+ ```
284
+
285
+ ### Curiosity-Gap Formulas
286
+ ```
287
+ The [Adjective] Secret Behind [Result]
288
+ What [Group] Don't Want You to Know About [Topic]
289
+ The [Surprising] Truth About [Topic]
290
+ [Result] — But Not the Way You Think
291
+ [Thing] Changed My [Life/Business/etc]. Here's How.
292
+ ```
293
+
294
+ ### Negative/Loss Aversion Formulas
295
+ ```
296
+ [Number] [Topic] Mistakes Destroying Your [Metric]
297
+ Warning: [Thing] Is [Damaging Your Thing]
298
+ Stop [Action] — It's Costing You [Metric]
299
+ Why [Thing] Is [Secretly/Actually] Bad For [You/Your Thing]
300
+ The [Hidden] Danger of [Common Practice]
301
+ ```
302
+
303
+ ---
304
+
305
+ ## Part 5: Platform-Specific Metrics
306
+
307
+ | Platform | Optimal Title Length | Target CTR | Priority Elements |
308
+ |----------|---------------------|------------|-------------------|
309
+ | YouTube | 50-60 chars | 7-15% | Numbers, emotions, curiosity |
310
+ | Reddit | 60-80 chars | N/A (upvote velocity) | Authenticity, specificity |
311
+ | Twitter/X | <280 chars | N/A | Hooks, threads, quotability |
312
+ | LinkedIn | 40-60 chars | N/A | Personal stories, contrarian |
313
+ | Blog/SEO | 50-70 chars | 3-5% organic | Keywords, search intent |
314
+ | Email | 30-50 chars | 20-30% open rate | Personalization, urgency |
315
+
316
+ ---
317
+
318
+ ## Part 6: Testing and Iteration
319
+
320
+ ### YouTube A/B Testing
321
+ - Use built-in YouTube thumbnail/title testing
322
+ - Measure CTR after 48-72 hours
323
+ - Test one variable at a time
324
+ - Document patterns that work for your audience
325
+
326
+ ### Blog Title Testing
327
+ - Use Headline Analyzer tools (CoSchedule, SEMrush)
328
+ - Track CTR from search results
329
+ - Monitor time-on-page vs bounce rate
330
+ - Higher CTR + high bounce = clickbait territory
331
+
332
+ ### Social Media Testing
333
+ - Post same content with different titles to different platforms
334
+ - Track engagement ratio (likes+comments / impressions)
335
+ - Document high-performers for future templates
336
+
337
+ ---
338
+
339
+ ## Part 7: Anti-Patterns to Avoid
340
+
341
+ ### Universal Anti-Patterns
342
+ - ❌ Generic vague titles ("Check this out", "Interesting read")
343
+ - ❌ Clickbait that doesn't deliver (destroys trust)
344
+ - ❌ ALL CAPS (looks spammy)
345
+ - ❌ Excessive punctuation (!!!, ?!?, ...)
346
+ - ❌ Keyword stuffing (reads as spam)
347
+ - ❌ Titles that spoil the content entirely
348
+ - ❌ First-person "I'm excited to share" openers (AI tell)
349
+ - ❌ "You won't believe" without substance
350
+
351
+ ### Platform-Specific Anti-Patterns
352
+
353
+ **YouTube:**
354
+ - Misleading thumbnails (hurts retention, algorithm penalty)
355
+ - Titles that don't match content
356
+ - Excessive length (truncation)
357
+
358
+ **Reddit:**
359
+ - Self-promotional without value
360
+ - Asking for upvotes
361
+ - Cross-posting identical titles without adaptation
362
+
363
+ **LinkedIn:**
364
+ - Pure promotional content
365
+ - Hashtag overload
366
+ - Corporate-speak without personal voice
367
+
368
+ ---
369
+
370
+ ## Part 8: Advanced Research Findings
371
+
372
+ ### Key Statistics from 20 Documented Sources
373
+
374
+ **Headline Performance Data:**
375
+ - Ideal headline length: **11 words / 65 characters** (BuzzSumo 100M study)
376
+ - Numbers boost engagement: **10 is the magic number**, followed by 3-7
377
+ - Negative superlatives outperform positive by **63%** (Outbrain study)
378
+ - Question headlines: 23% higher share rate than statements
379
+ - List headlines with numbers: 36% higher engagement
380
+
381
+ **Cross-Platform Insights:**
382
+ - TikTok hooks: first **1-3 seconds** determine video fate
383
+ - Email subject lines: **30-50 characters** optimal for mobile
384
+ - LinkedIn: personal story + professional lesson is the winning formula
385
+ - Reddit: authenticity and specificity beat hype
386
+ - Twitter/X: first line must have standalone viral potential
387
+
388
+ **Academic Research (Berger & Milkman):**
389
+ - High-arousal emotions drive sharing (positive OR negative)
390
+ - Awe increases sharing by **30%**
391
+ - Practical value content shared 34% more
392
+ - Surprising content shared 25% more
393
+
394
+ **The Upworthy Method:**
395
+ - Write **25 headline variations** minimum
396
+ - Test multiple versions (they tested dozens)
397
+ - Curiosity gap technique: peak + incomplete information
398
+ - 500% CTR improvement possible through testing
399
+
400
+ **Journalism Principles That Apply:**
401
+ - Inverted pyramid: most important first
402
+ - 5 W's framework: Who, What, When, Where, Why
403
+ - Simplicity performs best (linguistically accessible)
404
+ - Active voice creates energy
405
+
406
+ ---
407
+
408
+ ## Sources and Research Basis
409
+
410
+ This reference synthesizes research from 20 documented sources in `/research-viral-titles/`:
411
+
412
+ | Source | Focus | Key Contribution |
413
+ |--------|-------|------------------|
414
+ | BuzzSumo | 100M headlines analysis | Optimal length, number usage |
415
+ | Buffer | Psychology strategies | 8 proven headline techniques |
416
+ | Moz | SEO title optimization | Technical title tag guidelines |
417
+ | Copyblogger | Copywriting formulas | 11 classic headline templates |
418
+ | CoSchedule | Headline analysis | Scoring methodology |
419
+ | VidIQ | YouTube optimization | Platform-specific CTR tactics |
420
+ | HubSpot | Blog research | Engagement data and testing |
421
+ | Conductor | Preference study | User headline preferences |
422
+ | Outbrain | Negative superlatives | 63% higher CTR with negatives |
423
+ | Clickbait Psychology | Academic research | Information gap theory |
424
+ | MrBeast | YouTube analysis | Title formula breakdown |
425
+ | Berger-Milkman | Academic virality | Emotional drivers of sharing |
426
+ | Reddit | Platform optimization | Community-specific strategies |
427
+ | Veritasium | Clickbait strategy | Ethical attention capture |
428
+ | Upworthy | Headline testing | 25+ variation methodology |
429
+ | Email Subjects | Cross-platform | Mobile-first optimization |
430
+ | Twitter/X | Viral structure | Thread and hook patterns |
431
+ | LinkedIn | Professional context | Story-based engagement |
432
+ | TikTok | Hook optimization | 1-3 second capture window |
433
+ | Journalism | Traditional principles | Inverted pyramid, 5 W's |
434
+
435
+ ---
436
+
437
+ **Reference Version**: 2.0.0
438
+ **Date**: December 2025
439
+ **Research Expansion**: 20 documented sources (150KB+ research)
440
+ **For use with**: create-viral-content skill