@danhachuel/thunderbolt 0.2.49 → 0.2.50

package/seed/references/ai-tells.md

@@ -0,0 +1,336 @@
+# AI Tells: Complete Detection Guide
+
+This reference catalogs patterns that signal AI-generated content. Use during the humanization pass to hunt and eliminate.
+
+## Transition Phrases
+
+These phrases scream "ChatGPT wrote this":
+
+| AI Tell | Human Alternative |
+|---------|-------------------|
+| "Here's the wild part:" | [Just state it directly] |
+| "Here's the thing:" | [Remove entirely] |
+| "Let's dive in" | [Start with substance] |
+| "But here's the kicker:" | [Direct statement] |
+| "Here's what's interesting:" | [Remove, let interest emerge] |
+| "The key takeaway is:" | [Integrate into flow] |
+| "What's fascinating is:" | [Remove fascination claims] |
+| "Buckle up" | [Never use this] |
+| "Let me explain" | [Just explain] |
+| "First things first" | [Start with the first thing] |
+
+## Enthusiasm Tells
+
+AI compensates for lack of genuine insight with enthusiasm. Remove:
+
+- "I'm excited to share"
+- "This is a game-changer"
+- "Revolutionary"
+- "Groundbreaking"
+- "Transformative"
+- "Mind-blowing"
+- "Incredible"
+- "Amazing"
+- "Powerful" (when describing concepts)
+- "Leveraging the power of"
+
+**Rule:** If you have to tell readers something is exciting, it isn't.
+
+## Structure Tells
+
+AI defaults to rigid organization:
+
+- "First... Second... Third... Finally..."
+- Numbered lists for prose content
+- "In conclusion"
+- "To summarize"
+- "Let's break this down"
+- "There are X key points"
+- Excessive bullet points
+- Headers for every paragraph
+
+**Human pattern:** Prose flows. Structure serves meaning, not vice versa.
+
+## Corporate Speak
+
+AI training on corporate documents creates these:
+
+| AI Term | Human Alternative |
+|---------|-------------------|
+| "Leverage" | use |
+| "Utilize" | use |
+| "Implement" | build, try, do |
+| "Facilitate" | help, enable |
+| "Optimize" | improve |
+| "Streamline" | simplify |
+| "Robust" | strong, solid |
+| "Scalable" | grows, handles more |
+| "Ecosystem" | system, tools |
+| "Synergy" | [delete word entirely] |
+| "Best practices" | what works |
+| "Moving forward" | next |
+| "At the end of the day" | [remove] |
+| "Touch base" | talk, check in |
+| "Deep dive" | look closely, examine |
+
+## Engagement Bait
+
+Phrases that signal "I was trained to generate engagement":
+
+- "Change my mind"
+- "What do you think?"
+- "Let me know in the comments"
+- "Drop a 🔥 if you agree"
+- "Share if this resonated"
+- "Tag someone who needs this"
+- "Agree or disagree?"
+- "Am I the only one who thinks..."
+
+**Better approach:** End with a strong statement or actionable command.
+
+## Hedging Patterns
+
+AI over-hedges to seem balanced:
+
+- "It's worth noting that..."
+- "That being said..."
+- "On the other hand..."
+- "While this isn't for everyone..."
+- "Your mileage may vary"
+- "Of course, there are exceptions"
+- "To be fair..."
+
+**When to hedge:** Only when the nuance genuinely matters.
+
+## Filler Phrases
+
+Padding that adds no meaning:
+
+- "It goes without saying"
+- "Needless to say"
+- "As we all know"
+- "At the core"
+- "Fundamentally"
+- "Essentially"
+- "Basically"
+- "In essence"
+- "When it comes to"
+- "In terms of"
+- "As a matter of fact"
+
+**Rule:** If you can remove it and lose nothing, remove it.
+
+## Meta-Commentary
+
+AI explains what it's doing:
+
+- "I'll explain how..."
+- "Let me walk you through..."
+- "Here's a breakdown of..."
+- "This post will cover..."
+- "In this thread, I'll..."
+- "I want to share..."
+
+**Human pattern:** Just do the thing. Don't announce it.
+
+## Emoji Overuse
+
+AI-generated social content often:
+
+- Uses emojis as bullet points
+- Starts every line with an emoji
+- Uses 🚀 and 💡 and 🔥 excessively
+- Treats emojis as punctuation
+
+**Human pattern:** Emojis are seasoning, not the main dish. 0-2 per post max on most platforms.
+
+## The "Sounds Smart" Trap
+
+Phrases AI uses to seem intellectual:
+
+- "paradigm shift"
+- "framework for thinking about"
+- "mental model"
+- "first principles"
+- "unlock"
+- "supercharge"
+- "10x"
+- "level up"
+
+**When acceptable:** Only when the concept genuinely fits and you're not using it as a crutch.
+
+## Detection Heuristic
+
+Read your content aloud. If you wouldn't say it to a friend at a bar, rewrite it.
+
+**Bar test examples:**
+
+❌ "I'm excited to share a revolutionary framework that leverages AI to optimize your workflow. Here's the thing: traditional approaches are fundamentally flawed. Let me break this down..."
+
+✅ "So there's this technique where you make AI argue with itself before accepting an answer. Used to need like twelve different models to pull off. Now one model does it all. Way better results."
+
+## Humanization Checklist
+
+Before publishing, verify:
+
+- [ ] No transition tells in first paragraph
+- [ ] No enthusiasm adjectives
+- [ ] No corporate verbs
+- [ ] No engagement bait closer
+- [ ] No meta-commentary about what you're sharing
+- [ ] No excessive structure/numbering
+- [ ] Passes the bar test
+- [ ] Would not embarrass you if read aloud
+
+---
+
+## Platform-Specific AI Tells
+
+### TikTok/Reels Tells
+- ❌ "Wait for it..." (overused hook pattern)
+- ❌ "You won't believe..." (dated clickbait)
+- ❌ Starting with "So..." as opener
+- ❌ Excessive trending sound usage without relevance
+- ✅ Immediate visual hook
+- ✅ First 1-3 seconds must capture
+
+### LinkedIn Tells
+- ❌ "I'm proud to announce..."
+- ❌ "Excited to share that..."
+- ❌ Hashtag stuffing (#Success #Leadership #Growth)
+- ❌ "Agree?" as closer
+- ✅ Personal story opener
+- ✅ Contrarian framing
+
+### Reddit Tells
+- ❌ "I thought I'd share..."
+- ❌ "Just wanted to say..."
+- ❌ "Edit: Thanks for the awards!"
+- ❌ Cross-posting identical titles
+- ✅ Subreddit voice matching
+- ✅ Community-specific jargon
+
+### Email Subject Tells
+- ❌ "Quick question" (when it's not)
+- ❌ "Don't miss this!" (generic urgency)
+- ❌ ALL CAPS words
+- ❌ Excessive emojis 🚀🔥💡
+- ✅ Personalization that's genuine
+- ✅ Specific curiosity gaps
+
+---
+
+## Video Script AI Tells
+
+### Opener Tells
+- ❌ "Hey everyone, welcome back to the channel"
+- ❌ "Before we get started, make sure to like and subscribe"
+- ❌ "In today's video, we're going to talk about..."
+- ✅ Jump straight to the hook
+- ✅ Pattern interrupt in first 2 seconds
+
+### Mid-Video Tells
+- ❌ "So without further ado, let's dive in"
+- ❌ "Now, here's where it gets interesting"
+- ❌ "Let me break this down for you"
+- ✅ Deliver value immediately
+- ✅ Natural transitions through content flow
+
+### Outro Tells
+- ❌ "Let me know in the comments what you think"
+- ❌ "If you enjoyed this video, don't forget to..."
+- ❌ "See you in the next one!"
+- ✅ Strong declarative closer
+- ✅ Callback to opening hook
+
+---
+
+## Thumbnail Text Tells
+
+### Overused Phrases
+- ❌ "SHOCKING" / "INSANE" / "UNBELIEVABLE"
+- ❌ "YOU NEED TO SEE THIS"
+- ❌ "WATCH BEFORE IT'S DELETED"
+- ❌ Multiple exclamation points!!!
+- ✅ 3-4 word maximum
+- ✅ Specific numbers or outcomes
+
+### Typography Tells
+- ❌ Comic Sans or decorative fonts
+- ❌ Multiple font styles in one thumbnail
+- ❌ Text that repeats the title exactly
+- ❌ Small text that's illegible on mobile
+- ✅ Bold, sans-serif fonts only
+- ✅ High contrast with background
+
+---
+
+## The Complete Detection Heuristic
+
+**For text content:** Read aloud. Would you say this to a friend at a bar?
+
+**For video content:** Watch muted first 3 seconds. Would you stop scrolling?
+
+**For thumbnails:** View at 100px width. Is the message still clear?
+
+**For titles:** Remove your topic. Does the structure still feel generic?
+
+---
+
+## Punctuation Antipatterns (2024-2025)
+
+> **Research basis:** Cambridge University 2024, Originality.ai detection data. For the full comprehensive list, see the **humanize-writing** skill's `references/ai-vocabulary-list.md`.
+
+### Em-Dash Overuse
+AI (especially ChatGPT) overuses long dashes — like this — to add dramatic pauses.
+- **Threshold:** Max 1 per 500 words
+- **Fix:** Use commas or restructure
+
+### Paragraph Starters
+AI starts paragraphs with these + comma:
+- ❌ "However, ..."
+- ❌ "Moreover, ..."
+- ❌ "Overall, ..."
+- ❌ "Furthermore, ..."
+- ❌ "Importantly, ..."
+- ✅ Integrate contrast mid-sentence or delete
+
+### Pleonasms (Redundant Words)
+| ❌ AI Pattern | ✅ Fix |
+|--------------|--------|
+| "true fact" | "fact" |
+| "end result" | "result" |
+| "final outcome" | "outcome" |
+| "completely eliminate" | "eliminate" |
+| "close proximity" | "nearby" |
+
+### Tautologies (Same Thing Twice)
+| ❌ AI Pattern | ✅ Fix |
+|--------------|--------|
+| "collaborate together" | "collaborate" |
+| "join together" | "join" |
+| "revert back" | "revert" |
+| "repeat again" | "repeat" |
+
+### Burstiness (Sentence Variation)
+AI produces uniform sentence lengths. Humans vary dramatically.
+- **AI Pattern:** All sentences 15-18 words
+- **Human Pattern:** Mix of 4-word punches and 25-word flows
+- **Fix:** Add fragments. "Not everything needs a verb. Sometimes just a phrase."
+
+### Oxford Comma Consistency
+AI always uses Oxford comma. Humans are inconsistent.
+- **AI:** "red, white, and blue" (every time)
+- **Human:** Sometimes "red, white and blue"
+- **Fix:** Occasional variation is authentic
+
+### Multi-syllable Word Overuse
+AI prefers Latin-root words:
+| ❌ AI | ✅ Human |
+|------|---------|
+| "utilize" | "use" |
+| "demonstrate" | "show" |
+| "facilitate" | "help" |
+| "approximately" | "about" |
+
+**Threshold:** Multi-syllable words <20% of vocabulary.

package/seed/references/humanize-integration.md

@@ -0,0 +1,147 @@
+# Humanize-Writing Integration Guide
+
+This resource documents how the Deliberative Refinement skill integrates with the humanize-writing skill for final content polish.
+
+## Integration with **Deliberative Refinement** allows for rigorous checking associated with human-like writing qualities. invoked during the final pass to eliminate AI tells while preserving viral mechanics.
+
+### Invocation Template
+
+```
+Apply the humanize-writing skill to this draft. Focus on:
+- Ensuring natural sentence rhythm 
+- Maintaining the viral hooks I've established
+- Preserving platform-specific tone calibration
+```
+
+## Platform Calibration Matrix
+
+Different platforms require different humanization levels:
+
+| Platform | Humanize Intensity | Preserve | Special Considerations |
+|----------|-------------------|----------|----------------------|
+| Reddit | High - max casual | Hook, TL;DR | Subreddit voice matching |
+| LinkedIn | Medium - professional warmth | Authority, expertise signals | Story-based openers |
+| Twitter/X | Medium-High - punchy | Thread hooks, quotables | No 1/ numbering |
+| YouTube | High - conversational | Bold claims, engagement | First 2 seconds critical |
+| Hacker News | Medium - understated | Technical accuracy | Understate over overstate |
+| TikTok | High - ultra-casual | Immediate hook | 1-3 second capture window |
+| Instagram | High - visual-first | Caption hooks | Sound-off viewing common |
+| Email | Medium - personal | Subject line urgency | 30-50 char subjects |
+
+## Mapping to Humanize-Writing Phases
+
+### Phase 1: Identify AI Patterns
+From humanize-writing:
+- Scan for transition overuse ("Furthermore," "Here's the thing")
+- Check hedging language density
+- Identify marketing clichés
+
+**Viral content addition:**
+- Preserve intentional hook language
+- Keep platform-specific conventions
+
+### Phase 2: Apply Humanization
+From humanize-writing:
+- Replace AI vocabulary with human equivalents
+- Vary sentence patterns
+- Introduce human speech patterns
+
+**Viral content addition:**
+- Maintain hook architecture (first 2 seconds)
+- Preserve closer authority
+- Keep tribal identity patterns
+
+### Phase 3: Validate Against Checklist
+From humanize-writing:
+- No transitions in first sentence
+- Active voice dominates (70%+)
+- Personal voice present
+
+**Viral content addition:**
+- Hook strength verified
+- Platform word count met
+- Specificity ratio satisfied
+
+---
+
+## Video Script Humanization
+
+### Hook Humanization (First 3 Seconds)
+**Remove:**
+- "Hey everyone, welcome back"
+- "Before we start, like and subscribe"
+- "In today's video, we're going to..."
+
+**Replace with:**
+- Jump straight to the hook
+- Pattern interrupt opening
+- Immediate value or curiosity
+
+### Body Humanization
+**Remove:**
+- "So without further ado, let's dive in"
+- "Here's where it gets interesting"
+- Excessive signposting
+
+**Replace with:**
+- Natural flow between points
+- Conversational tangents where appropriate
+- Specific examples over abstract claims
+
+### Outro Humanization
+**Remove:**
+- "Let me know what you think in the comments"
+- "If you enjoyed this, don't forget to..."
+- Generic call to action
+
+**Replace with:**
+- Strong declarative statement
+- Callback to opening hook
+- Specific next action (not generic CTA)
+
+---
+
+## TikTok/Reels Humanization
+
+### Text Overlay Humanization
+- 1-2 words only if used
+- Hook in caption, not text overlay
+- Sound-off readability required
+
+### Caption Humanization
+- First 3 words must hook
+- Keywords early for discoverability
+- Avoid hashtag stuffing
+
+---
+
+## When Humanize-Writing Is Unavailable
+
+Use the built-in manual checklist in SKILL.md:
+
+1. Read aloud test
+2. Transition audit
+3. Enthusiasm check
+4. Specificity check
+5. Length check (cut 20%)
+
+## Technical Notes
+
+- Both skills can be installed simultaneously
+- Claude dynamically loads humanize-writing when referenced
+- Cross-skill calls do not require explicit imports
+- Skill descriptions determine when each activates
+
+---
+
+## Quick Reference: Humanization by Content Type
+
+| Content Type | Priority Removals | Priority Preserves |
+|--------------|-------------------|-------------------|
+| Reddit Post | Transition tells, engagement bait | Hook, TL;DR, specificity |
+| YouTube Script | Intro fluff, CTA begging | Hook, personality, closer |
+| TikTok | Verbose captions, explanation | Immediate hook, keywords |
+| LinkedIn | Corporate speak, hashtags | Story, contrarian angle |
+| Twitter Thread | Numbering, meta-commentary | Quotable lines, hooks |
+| Email | Generic urgency, ALL CAPS | Personalization, curiosity |
+

package/seed/references/thumbnail-checklist.md

@@ -0,0 +1,178 @@
+# Thumbnail Design Checklist
+
+> Quick-reference checklist for creating high-CTR thumbnails across platforms.
+
+---
+
+## Pre-Production Planning
+
+### Before You Film
+- [ ] Sketch thumbnail concept before filming
+- [ ] Plan specific shots for thumbnail capture
+- [ ] Prepare expression variations (surprise, excitement, curiosity)
+- [ ] Consider background color/setup
+- [ ] Plan any props or objects needed
+
+### Shot List for Thumbnail Capture
+- [ ] 10+ intentional thumbnail moments during filming
+- [ ] Multiple expressions (shock, surprise, excitement, curiosity)
+- [ ] Different angles (close-up, medium, wide)
+- [ ] Various compositions (left, center, right positioning)
+- [ ] Clean background options
+
+---
+
+## Design Checklist
+
+### Face and Expression
+- [ ] Face fills 30%+ of frame
+- [ ] Expression is instantly readable
+- [ ] Eyes are visible and expressive
+- [ ] Eye contact with camera (or strategic gaze direction)
+- [ ] Expression matches content tone
+- [ ] Maximum 1-2 faces (3+ = clutter)
+
+### Color and Contrast
+- [ ] High contrast between subject and background
+- [ ] Bold, vibrant colors (not muted)
+- [ ] Passes 60/30/10 rule (dominant/secondary/accent)
+- [ ] Doesn't blend with YouTube dark mode
+- [ ] Uses complementary colors for pop
+
+### Composition
+- [ ] Maximum 3 elements total
+- [ ] Subject not dead-center (rule of thirds)
+- [ ] Clear visual hierarchy
+- [ ] Negative space balanced
+- [ ] Key elements at intersection points
+
+### Text (If Used)
+- [ ] 3-4 words maximum
+- [ ] Bold, sans-serif font
+- [ ] Readable at 120px width (mobile test)
+- [ ] High contrast with background
+- [ ] Outline or shadow for readability
+- [ ] Doesn't duplicate title exactly
+- [ ] Doesn't cover face/subject
+
+---
+
+## Mobile Test Checklist
+
+### Small-Size Verification
+- [ ] View at 120x67px (YouTube mobile)
+- [ ] All text still readable
+- [ ] Face/expression still clear
+- [ ] Elements not cluttered
+- [ ] Clear focal point visible
+- [ ] Emotion still conveyed
+
+---
+
+## Platform Specifications
+
+| Platform | Resolution | Aspect Ratio | File Size |
+|----------|------------|--------------|-----------|
+| YouTube | 1280x720 min (1920x1080 rec) | 16:9 | <2MB |
+| TikTok | 1080x1920 | 9:16 | Varies |
+| Instagram Reels | 1080x1920 | 9:16 | Varies |
+| Pinterest | 1000x1500 | 2:3 | Varies |
+| Podcast | 1400x1400 min (3000x3000 max) | 1:1 | Varies |
+| Twitter/X | 1200x675 | 16:9 | <5MB |
+| LinkedIn | 1200x627 | ~1.91:1 | Varies |
+
+---
+
+## Title Synergy Check
+
+- [ ] Thumbnail and title complement (not duplicate) each other
+- [ ] Together they tell a complete story
+- [ ] Keywords are in title (SEO benefit)
+- [ ] Emotion is in thumbnail (visual impact)
+- [ ] Unified tone and message
+- [ ] Neither is redundant
+
+---
+
+## A/B Testing Checklist
+
+### Test Setup
+- [ ] Create 3-5 thumbnail variations
+- [ ] Change only one variable per variation
+- [ ] Use YouTube's Test & Compare feature (or TubeBuddy/VidIQ)
+- [ ] Document hypothesis for each variant
+
+### Variables to Test
+- [ ] Different expressions
+- [ ] Different text/no text
+- [ ] Different color treatments
+- [ ] Different element arrangements
+- [ ] Different background colors
+
+### Test Duration
+- [ ] Run for 7-14 days minimum
+- [ ] Ensure 1,000+ impressions per variant
+- [ ] Monitor CTR AND watch time
+- [ ] Document winning patterns
+
+---
+
+## Anti-Pattern Checklist
+
+### Design Mistakes to Avoid
+- [ ] NOT using dark/muddy colors
+- [ ] NOT using neutral expressions
+- [ ] NOT cluttering with 4+ elements
+- [ ] NOT using small/thin text
+- [ ] NOT placing text over face
+- [ ] NOT using dead-center composition
+
+### Strategic Mistakes to Avoid
+- [ ] NOT designing after video is filmed
+- [ ] NOT skipping mobile preview test
+- [ ] NOT copying title text exactly
+- [ ] NOT using clickbait that doesn't deliver
+- [ ] NOT ignoring A/B testing
+
+---
+
+## Scoring (Target: 20+)
+
+| Criteria | Score (0-3) |
+|----------|-------------|
+| Expression clarity | ____ |
+| Contrast/pop | ____ |
+| Simplicity (≤3 elements) | ____ |
+| Text readability | ____ |
+| Curiosity factor | ____ |
+| Mobile test pass | ____ |
+| Title synergy | ____ |
+| Brand recognition | ____ |
+| **TOTAL** | ____/24 |
+
+**Target: 20+ points before publishing**
+
+---
+
+## Quick Reference: High-CTR Elements
+
+### Expression Hierarchy (Effectiveness)
+1. **Shock/Surprise** — widened eyes, open mouth (highest CTR)
+2. **Excitement** — genuine smile, raised eyebrows
+3. **Curiosity** — furrowed brow, questioning look
+4. **Fear/Worry** — creates "what happened?" curiosity
+5. **Neutral** — lowest engagement (avoid)
+
+### Color Psychology
+| Color | Best For |
+|-------|----------|
+| Red | Urgency, action, alerts |
+| Orange | Entertainment, tutorials |
+| Yellow | Highlights, call-outs |
+| Blue | Educational, tech, trust |
+| Green | Self-improvement, success |
+| Purple | Luxury, creativity, mystery |
+
+---
+
+**Remember: Thumbnail + Title work as a package. Test them together.**