@danhachuel/thunderbolt 0.2.49 → 0.2.50

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,470 @@
1
+ # Viral Thumbnail Mastery
2
+
3
+ > ⚠️ **CRITICAL SECTION:** Thumbnails are responsible for 70%+ of video performance variability. This reference is mandatory reading before any thumbnail creation.
4
+
5
+ Thumbnails are visual hooks. Viewers make click decisions in under 0.5 seconds. The thumbnail must convey emotion, hint at content, and compel action—all at a glance.
6
+
7
+ ---
8
+
9
+ ## Part 1: The Psychology of Thumbnails
10
+
11
+ ### Why Thumbnails Work: Brain Science
12
+
13
+ **Visual Processing Speed**
14
+ The brain processes images 60,000x faster than text. Thumbnails bypass rational thought and trigger emotional/instinctual responses.
15
+
16
+ **Pattern Interrupt**
17
+ Scrolling creates hypnotic rhythm. Thumbnails that "break pattern"—through color, expression, or composition—snap attention.
18
+
19
+ **Face Recognition Hardwiring**
20
+ Humans have dedicated facial recognition neurology. Faces in thumbnails trigger instant emotional engagement.
21
+
22
+ ---
23
+
24
+ ## Part 2: Core Thumbnail Elements
25
+
26
+ ### 1. Faces and Expressions
27
+
28
+ **Impact:** Thumbnails with faces see 35-50% higher CTR.
29
+
30
+ **Why faces work:**
31
+ - Brain's fusiform face area activates automatically
32
+ - Emotions are instantly readable
33
+ - Creates personal connection and trust
34
+ - Viewers mirror emotions subconsciously
35
+
36
+ **Expression hierarchy (effectiveness):**
37
+ 1. **Shock/Surprise** — widened eyes, open mouth (highest CTR)
38
+ 2. **Excitement** — genuine smile, raised eyebrows
39
+ 3. **Curiosity** — furrowed brow, questioning look
40
+ 4. **Fear/Worry** — creates "what happened?" curiosity
41
+ 5. **Neutral** — lowest engagement (avoid)
42
+
43
+ **Best practices:**
44
+ - Close-up shots (face fills 30%+ of frame)
45
+ - Eye contact with camera (direct viewer connection)
46
+ - Exaggerated but authentic expressions
47
+ - Strategic gaze direction (eyes pointing toward text/action)
48
+
49
+ **Anti-patterns:**
50
+ - ❌ Fake/forced expressions (uncanny valley effect)
51
+ - ❌ Multiple faces competing for attention
52
+ - ❌ Obscured or tiny faces
53
+ - ❌ Neutral "passport photo" expressions
54
+
55
+ ### 2. Color and Contrast
56
+
57
+ **Impact:** Contrasting color thumbnails have 30% higher CTR.
58
+
59
+ **Color psychology:**
60
+ | Color | Association | Best for |
61
+ |-------|-------------|----------|
62
+ | Red | Urgency, energy, passion | Action, alerts, excitement |
63
+ | Orange | Enthusiasm, creativity | Entertainment, tutorials |
64
+ | Yellow | Optimism, attention | Highlights, call-outs |
65
+ | Blue | Trust, calm, authority | Educational, tech, finance |
66
+ | Green | Growth, success, nature | Self-improvement, eco |
67
+ | Purple | Premium, creativity | Luxury, mystery |
68
+ | Black | Power, sophistication | Drama, premium |
69
+ | White | Clean, minimal | Tech, lifestyle |
70
+
71
+ **Color rules:**
72
+ - Use complementary colors (opposite on color wheel) for maximum pop
73
+ - Blue + Orange, Red + Cyan, Purple + Yellow = high contrast pairs
74
+ - 60/30/10 rule: 60% dominant, 30% secondary, 10% accent
75
+ - Avoid YouTube red (blends with UI)
76
+
77
+ **Contrast techniques:**
78
+ - Light subject on dark background (or vice versa)
79
+ - Colored outlines/glows around subjects
80
+ - Gradient backgrounds (top-to-bottom)
81
+ - Vignette effects to draw eye to center
82
+
83
+ ### 3. Text Overlays
84
+
85
+ **Impact:** 3-4 words maximum. More = 30% lower CTR.
86
+
87
+ **Text rules:**
88
+ - Maximum 3-4 words
89
+ - Bold, sans-serif fonts (readable at 100px)
90
+ - High contrast against background
91
+ - Add outline or shadow for readability
92
+ - Never duplicate the title exactly
93
+
94
+ **Effective text types:**
95
+ - Hook words: "SECRET", "FREE", "$100K", "BANNED"
96
+ - Numbers: "24H", "#1", "10X", "3 STEPS"
97
+ - Emotion words: "INSANE", "WOW", "SHOCKING"
98
+ - Value indicators: "FULL GUIDE", "REVIEW", "VS"
99
+
100
+ **Anti-patterns:**
101
+ - ❌ Full sentences (too much to read)
102
+ - ❌ Small text (illegible on mobile)
103
+ - ❌ Thin fonts (disappear at small sizes)
104
+ - ❌ Multiple text blocks competing
105
+ - ❌ Text that covers face/subject
106
+
107
+ ### 4. Composition and Layout
108
+
109
+ **The Rule of Thirds:**
110
+ - Divide frame into 3x3 grid
111
+ - Place key elements at intersection points
112
+ - Subject slightly off-center = dynamic
113
+ - Subject dead-center = static/boring
114
+
115
+ **Visual hierarchy:**
116
+ 1. Face/Subject (primary attention)
117
+ 2. Key action/object (secondary)
118
+ 3. Text overlay (tertiary)
119
+ 4. Background (supporting)
120
+
121
+ **Mobile optimization (60%+ of views):**
122
+ - Thumbnails display at ~120px width on mobile
123
+ - All text must be readable at thumbnail size
124
+ - Fewer elements = better mobile performance
125
+ - Test at small size before finalizing
126
+
127
+ **Negative space:**
128
+ - Leave room for text overlays
129
+ - Too busy = confusing at small size
130
+ - Balance subject with breathing room
131
+
132
+ ### 5. Visual Storytelling
133
+
134
+ **Show, don't tell:**
135
+ The best thumbnails tell a story in a single frame.
136
+
137
+ **Before/After visualization:**
138
+ Split screen or implied transformation
139
+
140
+ **Scale contrasts:**
141
+ Big vs small, many vs one, full vs empty
142
+
143
+ **Tension/Conflict:**
144
+ Two opposing elements creating question
145
+
146
+ **Progress implied:**
147
+ Start state → end state visible
148
+
149
+ ### 6. Consistency and Branding
150
+
151
+ **Recognition benefits:**
152
+ Consistent style = faster recognition = higher CTR from subscribers
153
+
154
+ **Branding elements:**
155
+ - Consistent color palette across videos
156
+ - Recognizable face/avatar placement
157
+ - Signature fonts and text style
158
+ - Logo placement (subtle, corner)
159
+
160
+ **Series thumbnails:**
161
+ - Same template, different content
162
+ - Number/part indicators
163
+ - Color coding by series
164
+
165
+ ---
166
+
167
+ ## Part 3: The MrBeast Thumbnail Method
168
+
169
+ MrBeast's thumbnails consistently achieve 10%+ CTR through these principles:
170
+
171
+ ### "Limit Your Lamborghinis"
172
+ - Maximum 3 elements in frame
173
+ - One person, one object, one text maximum
174
+ - If in doubt, remove something
175
+
176
+ ### Pre-Production Design
177
+ - Sketch thumbnail before filming
178
+ - Plan shots specifically for thumbnail capture
179
+ - The video serves the thumbnail, not vice versa
180
+
181
+ ### Color Dominance
182
+ - One dominant color per thumbnail
183
+ - Saturated, bright backgrounds
184
+ - Green and blue backgrounds correlate with higher CTR (research-backed)
185
+
186
+ ### Expression Hierarchy
187
+ - Face is THE focus
188
+ - Expressions are exaggerated but authentic
189
+ - Eyes always visible and expressive
190
+
191
+ ### A/B Testing Everything
192
+ - Multiple thumbnail versions tested
193
+ - Data-driven iteration
194
+ - Change one variable at a time
195
+
196
+ ---
197
+
198
+ ## Part 4: Thumbnail Creation Protocol
199
+
200
+ ### Step 1: Concept Before Content
201
+ Sketch the thumbnail before filming. Ensure the concept is visually compelling.
202
+
203
+ ### Step 2: Capture Multiple Options
204
+ During filming, capture 10+ intentional thumbnail moments:
205
+ - Different expressions
206
+ - Different angles
207
+ - Different compositions
208
+
209
+ ### Step 3: Design Multiple Versions
210
+ Create 3-5 variations:
211
+ - Different expressions
212
+ - Different text
213
+ - Different color treatments
214
+ - Different element arrangements
215
+
216
+ ### Step 4: Mobile Preview Test
217
+ View all options at thumbnail size (120x67px).
218
+ Eliminate any that:
219
+ - Have unreadable text
220
+ - Lack clear focus
221
+ - Look cluttered
222
+ - Don't convey emotion
223
+
224
+ ### Step 5: A/B Test (When Possible)
225
+ - YouTube allows thumbnail testing
226
+ - Run for 48-72 hours
227
+ - Measure CTR difference
228
+ - Document winning patterns
229
+
230
+ ### Step 6: Iterate Based on Data
231
+ Track which strategies work for YOUR audience.
232
+ General rules are starting points, not absolutes.
233
+
234
+ ---
235
+
236
+ ## Part 5: AI Thumbnail Prompt Templates
237
+
238
+ For generating thumbnails with AI image tools (Midjourney, DALL-E, Stable Diffusion):
239
+
240
+ ### Expression-Focused Portrait
241
+ ```
242
+ [person descriptor] with [expression: shocked/excited/surprised/curious] expression,
243
+ close-up portrait, looking directly at camera,
244
+ [vibrant/bold] [color] background, studio lighting,
245
+ high contrast, YouTube thumbnail style,
246
+ [optional: holding [object]],
247
+ clean composition, no text
248
+ ```
249
+
250
+ ### Before/After Concept
251
+ ```
252
+ split screen image showing [before state] on left and [after state] on right,
253
+ dramatic transformation visible,
254
+ [color scheme] color palette,
255
+ clean professional style,
256
+ YouTube thumbnail composition,
257
+ high contrast, no text
258
+ ```
259
+
260
+ ### Reaction/Discovery
261
+ ```
262
+ [person descriptor] reacting to [surprising element] with [shocked/amazed] expression,
263
+ [action/object] clearly visible in frame,
264
+ [dramatic lighting/color scheme],
265
+ YouTube thumbnail style,
266
+ clean composition, maximum 3 elements,
267
+ no text overlay
268
+ ```
269
+
270
+ ### Product/Comparison
271
+ ```
272
+ [object 1] vs [object 2] dramatic comparison,
273
+ studio setup,
274
+ [bright/contrasting colors] background,
275
+ clean composition,
276
+ high-end product photography style,
277
+ YouTube thumbnail perspective,
278
+ no text
279
+ ```
280
+
281
+ ### Scale Emphasis
282
+ ```
283
+ [large object/amount] next to [small reference for scale],
284
+ dramatic perspective emphasizing size,
285
+ [person showing reaction to scale],
286
+ bright contrasting colors,
287
+ clean YouTube thumbnail composition,
288
+ no text
289
+ ```
290
+
291
+ ---
292
+
293
+ ## Part 6: Technical Specifications
294
+
295
+ ### YouTube Requirements
296
+ - Resolution: 1280 x 720 pixels (minimum)
297
+ - Recommended: 1920 x 1080 pixels
298
+ - Aspect ratio: 16:9
299
+ - Format: JPG, GIF, PNG
300
+ - Max size: 2MB
301
+
302
+ ### File Export Settings
303
+ - Color space: sRGB
304
+ - Quality: 85-95% JPEG compression
305
+ - Save PNG for graphics/text-heavy designs
306
+
307
+ ### Safe Zones
308
+ - Keep text away from edges (10% margin)
309
+ - Bottom-right: YouTube timestamp overlay
310
+ - Top-left: "HD" badge possible
311
+ - Consider YouTube UI overlays
312
+
313
+ ---
314
+
315
+ ## Part 7: Platform Adaptations
316
+
317
+ ### YouTube
318
+ - Full thumbnail-title synergy required
319
+ - Thumbnail and title work together, not redundantly
320
+ - Face + 2-3 elements max
321
+
322
+ ### Twitter/X Video
323
+ - Thumbnails show at smaller size
324
+ - Simpler is better
325
+ - Text must be minimal
326
+
327
+ ### LinkedIn Video
328
+ - Professional, less exaggerated
329
+ - Blue/neutral tones often perform better
330
+ - Clear, clean compositions
331
+
332
+ ### Instagram Reels
333
+ - Thumbnail less important (auto-play)
334
+ - Focus first frame instead
335
+ - Text on cover image optional
336
+
337
+ ### TikTok
338
+ - Cover image selection
339
+ - Hook in first frame matters more
340
+ - Bright, high-contrast
341
+
342
+ ---
343
+
344
+ ## Part 8: Common Mistakes
345
+
346
+ ### Design Mistakes
347
+ - ❌ Too many elements (>3)
348
+ - ❌ Text too small (illegible on mobile)
349
+ - ❌ Low contrast (doesn't pop)
350
+ - ❌ Dark/muddy colors
351
+ - ❌ Neutral expressions
352
+ - ❌ Dead-center composition
353
+
354
+ ### Strategic Mistakes
355
+ - ❌ Designing thumbnail after video
356
+ - ❌ Not testing variations
357
+ - ❌ Ignoring mobile preview
358
+ - ❌ Copying title exactly in thumbnail
359
+ - ❌ Inconsistent branding
360
+ - ❌ Clickbait that doesn't deliver
361
+
362
+ ### Technical Mistakes
363
+ - ❌ Wrong aspect ratio
364
+ - ❌ Low resolution
365
+ - ❌ Over-compressed JPEG artifacts
366
+ - ❌ Tiny file size (under 100KB = likely poor quality)
367
+
368
+ ---
369
+
370
+ ## Part 9: Thumbnail Scoring Checklist
371
+
372
+ Before publishing, score your thumbnail:
373
+
374
+ | Criteria | Score (0-3) |
375
+ |----------|-------------|
376
+ | **Expression clarity** — Is emotion instantly readable? | |
377
+ | **Contrast** — Does it pop at thumbnail size? | |
378
+ | **Simplicity** — 3 elements or fewer? | |
379
+ | **Text readability** — Legible at 120px width? | |
380
+ | **Curiosity factor** — Does it demand a click? | |
381
+ | **Mobile test** — Passes small-size preview? | |
382
+ | **Title synergy** — Works with, not duplicates, title? | |
383
+ | **Branding** — Recognizable as your content? | |
384
+
385
+ **Target: 20+ total score (8 criteria × avg 2.5+)**
386
+
387
+ ---
388
+
389
+ ## Part 10: Advanced Research Findings
390
+
391
+ ### Key Statistics from 20 Documented Sources
392
+
393
+ **CTR Impact Data:**
394
+ - Custom thumbnails: **90% of top videos** use them
395
+ - Faces increase CTR: **35-50%** improvement
396
+ - High-contrast colors: **+20-30% CTR**
397
+ - Personalized thumbnails: **+30% clicks** (Netflix study)
398
+ - A/B testing improvements: **30-40%** CTR gain over time
399
+ - Thumbnails impact CTR by **up to 300%** (YouTube research)
400
+
401
+ **Neuroscience Findings:**
402
+ - Brain processes faces in **milliseconds** (amygdala activation)
403
+ - Exaggerated expressions: **+34% emotional engagement**
404
+ - 3+ faces = clutter (negative impact)
405
+ - Eye contact creates connection and curiosity
406
+ - Complex emotions outperform simple smiles
407
+
408
+ **Netflix Personalization Insights:**
409
+ - **82%** of browsing time spent on thumbnails
410
+ - Users spend only **1.8 seconds** per thumbnail decision
411
+ - Contextual bandits algorithm for real-time matching
412
+ - Thumbnails can change daily based on user preferences
413
+
414
+ **Platform Specifications:**
415
+ | Platform | Aspect Ratio | Dimensions |
416
+ |----------|--------------|------------|
417
+ | YouTube | 16:9 | 1280x720 min |
418
+ | TikTok | 9:16 | 1080x1920 |
419
+ | Instagram Reels | 9:16 | 1080x1920 |
420
+ | Pinterest | 2:3 | 1000x1500 |
421
+ | Podcast | 1:1 | 1400x1400 min |
422
+ | App Store | 1:1 | Varies |
423
+
424
+ **Composition Principles:**
425
+ - Rule of Thirds: place key elements at intersection points
426
+ - Golden Ratio (1:1.618): natural visual balance
427
+ - 60/30/10 color rule: dominant, secondary, accent
428
+ - Low visual complexity = longer fixation time
429
+
430
+ **Thumbnail-Title Synergy:**
431
+ - Don't duplicate information
432
+ - Title carries keywords (SEO)
433
+ - Thumbnail carries emotion (visual impact)
434
+ - Test as combined package
435
+
436
+ ---
437
+
438
+ ## Sources and Research Basis
439
+
440
+ This reference synthesizes research from 20 documented sources in `/research-viral-thumbnails/`:
441
+
442
+ | Source | Focus | Key Contribution |
443
+ |--------|-------|------------------|
444
+ | Psychology-CTR | Visual psychology | Core CTR statistics |
445
+ | Face Neuroscience | Brain science | Amygdala activation research |
446
+ | MrBeast Thumbnails | Creator analysis | Minimalist focus method |
447
+ | Color Theory | Visual design | 60/30/10 rule, complementary colors |
448
+ | VidIQ/TubeBuddy | Platform tools | A/B testing methodology |
449
+ | Typography | Text design | Font selection, contrast ratios |
450
+ | Social Media Images | Cross-platform | Instagram/Pinterest optimization |
451
+ | Blog Images | Content marketing | Featured image CTR impact |
452
+ | A/B Testing | Methodology | Statistical testing approach |
453
+ | Eye Tracking | UX research | Heat maps, F-pattern scanning |
454
+ | Netflix | Personalization | Algorithm insights, 1.8s decisions |
455
+ | App Store Icons | ASO | Mobile icon conversion |
456
+ | Podcast Covers | Audio platforms | Square format guidelines |
457
+ | Composition | Photography | Rule of Thirds, Golden Ratio |
458
+ | Advertising Banners | Ad research | Gaze direction studies |
459
+ | Transformation | Pattern analysis | Before/after effectiveness |
460
+ | Object-Focused | Pattern analysis | Product thumbnail design |
461
+ | Text Approaches | Comparison | Text-heavy vs minimal |
462
+ | Title Synergy | Strategy | Thumbnail-title coordination |
463
+ | Platform-Specific | Multi-platform | Aspect ratios, specifications |
464
+
465
+ ---
466
+
467
+ **Reference Version**: 2.0.0
468
+ **Date**: December 2025
469
+ **Research Expansion**: 20 documented sources (56KB+ research)
470
+ **For use with**: create-viral-content skill