rickub
hlassiege/darylpublic Fork
⑂ c123cdd
Branches
main View all branches → View all tags →
Commits
⬇ Clone ▾
git clone https://git.rickub.com/hlassiege/daryl.git
git clone ssh://git@rickub.com/hlassiege/daryl.git

Host key fingerprint (ed25519): SHA256:iycHnxEyq0Q7uyVpB7JlznP0G7JrTPXLYRcAU5CSLhc — verify it before your first connect.

Download ZIP

feat(skills): add YouTube scriptwriting, thumbnail and title skills

hlassiege committed 2026-10-11T13:01:48+02:00 Browse files
c123cdd parent: 6b1db17
added skills/youtube-scriptwriting/.skillfish.json +10 -0
new file mode 100644
@@ -0,0 +1,10 @@
1+{
2+ "version": 2,
3+ "name": "youtube-scriptwriting",
4+ "owner": "cdeistopened",
5+ "repo": "skill-stack",
6+ "path": ".claude/skills/youtube-scriptwriting",
7+ "branch": "main",
8+ "sha": "55c1b84b2e57ce3b5354518be924b36df4f911bd",
9+ "source": "manual"
10+}
\ No newline at end of file
new file mode 100644
@@ -0,0 +1,10 @@
1+{
2+ "version": 2,
3+ "name": "youtube-scriptwriting",
4+ "owner": "cdeistopened",
5+ "repo": "skill-stack",
6+ "path": ".claude/skills/youtube-scriptwriting",
7+ "branch": "main",
8+ "sha": "55c1b84b2e57ce3b5354518be924b36df4f911bd",
9+ "source": "manual"
10+}
\ No newline at end of file\ No newline at end of file
added skills/youtube-scriptwriting/LICENSE +21 -0
new file mode 100644
@@ -0,0 +1,21 @@
1+MIT License
2+
3+Copyright (c) 2025 Wayne Sutton
4+
5+Permission is hereby granted, free of charge, to any person obtaining a copy
6+of this software and associated documentation files (the "Software"), to deal
7+in the Software without restriction, including without limitation the rights
8+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+copies of the Software, and to permit persons to whom the Software is
10+furnished to do so, subject to the following conditions:
11+
12+The above copyright notice and this permission notice shall be included in all
13+copies or substantial portions of the Software.
14+
15+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+SOFTWARE.
new file mode 100644
@@ -0,0 +1,21 @@
1+MIT License
2+
3+Copyright (c) 2025 Wayne Sutton
4+
5+Permission is hereby granted, free of charge, to any person obtaining a copy
6+of this software and associated documentation files (the "Software"), to deal
7+in the Software without restriction, including without limitation the rights
8+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+copies of the Software, and to permit persons to whom the Software is
10+furnished to do so, subject to the following conditions:
11+
12+The above copyright notice and this permission notice shall be included in all
13+copies or substantial portions of the Software.
14+
15+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+SOFTWARE.
added skills/youtube-scriptwriting/SKILL.md +144 -0
new file mode 100644
@@ -0,0 +1,144 @@
1+---
2+name: youtube-scriptwriting
3+description: Transform raw ideas and brain dumps into polished YouTube scripts through a structured checkpoint workflow. Use when the user wants to write a YouTube script, improve video retention, craft hooks, structure educational or entertainment content, or turn source material (transcripts, notes, research) into a compelling video script. Guides through research, hook writing, story structure, body content, and editing phases.
4+---
5+
6+# YouTube Script Writing
7+
8+Transform disorganized ideas into retention-optimized scripts through a checkpoint-based workflow.
9+
10+## Core Psychology
11+
12+All great scripts operate on one principle: **Reality must beat expectations.**
13+
14+- Viewer expectations = what they think will happen based on title/thumbnail
15+- Reality = what you actually deliver in the video
16+- When reality > expectations → satisfaction, engagement, shares
17+- When reality < expectations → disappointment, drop-off, bounce
18+
19+Every decision in scriptwriting serves this gap.
20+
21+## The Workflow
22+
23+Work through these checkpoints in order. Each builds on the previous.
24+
25+### Checkpoint 1: Define the Foundation
26+
27+Before writing anything:
28+
29+1. **Target audience**: Who specifically is watching? What do they already know?
30+2. **Desired emotion**: Pick ONE primary emotion to transfer:
31+ - Awe/inspiration
32+ - Amusement/humor
33+ - Excitement/joy
34+ - Anger/outrage
35+ - Surprise/shock/curiosity
36+ - Sadness/empathy
37+3. **Core promise**: One sentence describing what viewer gets from watching
38+
39+### Checkpoint 2: Research & Mine for Shock
40+
41+Find the facts that will beat expectations. See [references/research.md](references/research.md).
42+
43+**Shock Score Method**: Rate each fact 1-100 based on "How many viewers would NOT know this?"
44+- 80+ = Gold (most viewers surprised)
45+- 50-79 = Good supporting points
46+- Below 50 = Skip unless essential context
47+
48+Collect 5-10 high-shock facts before proceeding.
49+
50+### Checkpoint 3: Write the Hook
51+
52+The hook confirms the click and opens a curiosity loop. See [references/hooks.md](references/hooks.md) for the 9 proven formats.
53+
54+**Quick Formula** (works for any niche):
55+- **Target**: Who is this for?
56+- **Transformation**: What will they gain?
57+- **Stakes**: What happens if they don't watch?
58+
59+**Hook Commandments** (verify all 4):
60+1. Alignment: Visual, spoken, and text hooks match
61+2. Speed: Value promised in first 3 seconds
62+3. Clarity: Topic is unmistakable
63+4. Curiosity: Opens a question they must answer
64+
65+### Checkpoint 4: Choose Story Structure & Outline
66+
67+Pick ONE structure that fits your content. See [references/structures.md](references/structures.md) for all 7 formats.
68+
69+**Most Common Structures**:
70+- **Tutorial**: Step-by-step process → Hook → Steps → Outro
71+- **Listicle**: Ordered items → Hook → List → Outro
72+- **Problem-Solver**: Pain → Solution → Hook → Problem → Solution → Outro
73+- **Case Study**: How X achieved Y → Hook → Framework → Outro
74+
75+Create a bullet outline BEFORE writing. Sequence your shock facts logically.
76+
77+### Checkpoint 5: Write the Body
78+
79+For each section, use the **Value Loop**:
80+1. **Context**: What is it? (Simple, clear)
81+2. **Application**: How to use it? (Examples)
82+3. **Framing**: Why does it matter? (Connect to bigger picture)
83+
84+**Retention Techniques** (see [references/retention.md](references/retention.md)):
85+- **Rehooks**: Every 30-60 seconds, reagitate the promise ("But here's where it gets interesting...")
86+- **Setups & Payoffs**: Tease information, delay reveal, then deliver
87+- **Second-best first**: Put your second-best point first, best point second (creates ascending pattern)
88+
89+### Checkpoint 6: Edit for Quality
90+
91+Run three audits on your draft. See [references/editing.md](references/editing.md).
92+
93+**1. Story Flow Audit**
94+- Read each line: Is this necessary or a tangent?
95+- Delete anything that breaks the through-line
96+- Test: Can viewer follow beginning to end without getting lost?
97+
98+**2. Comprehension Audit**
99+- Target 6th grade vocabulary
100+- Shorter sentences (staccato, not run-on)
101+- Active voice ("The dog jumped" not "The jumping was done by the dog")
102+- Restate complex ideas twice, second time simpler
103+
104+**3. Speed-to-Value Audit**
105+- Is value signaled in first 3 seconds?
106+- Rehooks every 30-60 seconds?
107+- Outro summarizes or extends value?
108+
109+### Checkpoint 7: Outro & CTA
110+
111+**Binge Loop Formula** (last 15-30 seconds):
112+1. Link back to video content naturally
113+2. Introduce a NEW problem/question
114+3. Promise to solve it in another video or resource
115+
116+## Quick Reference: Script Template
117+
118+```
119+HOOK (0-15 seconds)
120+- Confirm the click
121+- Open curiosity loop
122+- Establish credibility (optional)
123+
124+BODY SECTION 1 (Rehook → Content → Payoff)
125+[Second-best point]
126+
127+BODY SECTION 2 (Rehook → Content → Payoff)
128+[Best point]
129+
130+BODY SECTION 3+ (Rehook → Content → Payoff)
131+[Remaining points in descending order]
132+
133+OUTRO (Last 15-30 seconds)
134+- Summarize value delivered
135+- Binge loop to next video/resource
136+```
137+
138+## When to Use Each Reference
139+
140+- **Starting from scratch with no topic?** → [references/research.md](references/research.md)
141+- **Stuck on how to start the video?** → [references/hooks.md](references/hooks.md)
142+- **Don't know how to organize points?** → [references/structures.md](references/structures.md)
143+- **Retention dropping mid-video?** → [references/retention.md](references/retention.md)
144+- **Script feels clunky or confusing?** → [references/editing.md](references/editing.md)
new file mode 100644
@@ -0,0 +1,144 @@
1+---
2+name: youtube-scriptwriting
3+description: Transform raw ideas and brain dumps into polished YouTube scripts through a structured checkpoint workflow. Use when the user wants to write a YouTube script, improve video retention, craft hooks, structure educational or entertainment content, or turn source material (transcripts, notes, research) into a compelling video script. Guides through research, hook writing, story structure, body content, and editing phases.
4+---
5+
6+# YouTube Script Writing
7+
8+Transform disorganized ideas into retention-optimized scripts through a checkpoint-based workflow.
9+
10+## Core Psychology
11+
12+All great scripts operate on one principle: **Reality must beat expectations.**
13+
14+- Viewer expectations = what they think will happen based on title/thumbnail
15+- Reality = what you actually deliver in the video
16+- When reality > expectations → satisfaction, engagement, shares
17+- When reality < expectations → disappointment, drop-off, bounce
18+
19+Every decision in scriptwriting serves this gap.
20+
21+## The Workflow
22+
23+Work through these checkpoints in order. Each builds on the previous.
24+
25+### Checkpoint 1: Define the Foundation
26+
27+Before writing anything:
28+
29+1. **Target audience**: Who specifically is watching? What do they already know?
30+2. **Desired emotion**: Pick ONE primary emotion to transfer:
31+ - Awe/inspiration
32+ - Amusement/humor
33+ - Excitement/joy
34+ - Anger/outrage
35+ - Surprise/shock/curiosity
36+ - Sadness/empathy
37+3. **Core promise**: One sentence describing what viewer gets from watching
38+
39+### Checkpoint 2: Research & Mine for Shock
40+
41+Find the facts that will beat expectations. See [references/research.md](references/research.md).
42+
43+**Shock Score Method**: Rate each fact 1-100 based on "How many viewers would NOT know this?"
44+- 80+ = Gold (most viewers surprised)
45+- 50-79 = Good supporting points
46+- Below 50 = Skip unless essential context
47+
48+Collect 5-10 high-shock facts before proceeding.
49+
50+### Checkpoint 3: Write the Hook
51+
52+The hook confirms the click and opens a curiosity loop. See [references/hooks.md](references/hooks.md) for the 9 proven formats.
53+
54+**Quick Formula** (works for any niche):
55+- **Target**: Who is this for?
56+- **Transformation**: What will they gain?
57+- **Stakes**: What happens if they don't watch?
58+
59+**Hook Commandments** (verify all 4):
60+1. Alignment: Visual, spoken, and text hooks match
61+2. Speed: Value promised in first 3 seconds
62+3. Clarity: Topic is unmistakable
63+4. Curiosity: Opens a question they must answer
64+
65+### Checkpoint 4: Choose Story Structure & Outline
66+
67+Pick ONE structure that fits your content. See [references/structures.md](references/structures.md) for all 7 formats.
68+
69+**Most Common Structures**:
70+- **Tutorial**: Step-by-step process → Hook → Steps → Outro
71+- **Listicle**: Ordered items → Hook → List → Outro
72+- **Problem-Solver**: Pain → Solution → Hook → Problem → Solution → Outro
73+- **Case Study**: How X achieved Y → Hook → Framework → Outro
74+
75+Create a bullet outline BEFORE writing. Sequence your shock facts logically.
76+
77+### Checkpoint 5: Write the Body
78+
79+For each section, use the **Value Loop**:
80+1. **Context**: What is it? (Simple, clear)
81+2. **Application**: How to use it? (Examples)
82+3. **Framing**: Why does it matter? (Connect to bigger picture)
83+
84+**Retention Techniques** (see [references/retention.md](references/retention.md)):
85+- **Rehooks**: Every 30-60 seconds, reagitate the promise ("But here's where it gets interesting...")
86+- **Setups & Payoffs**: Tease information, delay reveal, then deliver
87+- **Second-best first**: Put your second-best point first, best point second (creates ascending pattern)
88+
89+### Checkpoint 6: Edit for Quality
90+
91+Run three audits on your draft. See [references/editing.md](references/editing.md).
92+
93+**1. Story Flow Audit**
94+- Read each line: Is this necessary or a tangent?
95+- Delete anything that breaks the through-line
96+- Test: Can viewer follow beginning to end without getting lost?
97+
98+**2. Comprehension Audit**
99+- Target 6th grade vocabulary
100+- Shorter sentences (staccato, not run-on)
101+- Active voice ("The dog jumped" not "The jumping was done by the dog")
102+- Restate complex ideas twice, second time simpler
103+
104+**3. Speed-to-Value Audit**
105+- Is value signaled in first 3 seconds?
106+- Rehooks every 30-60 seconds?
107+- Outro summarizes or extends value?
108+
109+### Checkpoint 7: Outro & CTA
110+
111+**Binge Loop Formula** (last 15-30 seconds):
112+1. Link back to video content naturally
113+2. Introduce a NEW problem/question
114+3. Promise to solve it in another video or resource
115+
116+## Quick Reference: Script Template
117+
118+```
119+HOOK (0-15 seconds)
120+- Confirm the click
121+- Open curiosity loop
122+- Establish credibility (optional)
123+
124+BODY SECTION 1 (Rehook → Content → Payoff)
125+[Second-best point]
126+
127+BODY SECTION 2 (Rehook → Content → Payoff)
128+[Best point]
129+
130+BODY SECTION 3+ (Rehook → Content → Payoff)
131+[Remaining points in descending order]
132+
133+OUTRO (Last 15-30 seconds)
134+- Summarize value delivered
135+- Binge loop to next video/resource
136+```
137+
138+## When to Use Each Reference
139+
140+- **Starting from scratch with no topic?** → [references/research.md](references/research.md)
141+- **Stuck on how to start the video?** → [references/hooks.md](references/hooks.md)
142+- **Don't know how to organize points?** → [references/structures.md](references/structures.md)
143+- **Retention dropping mid-video?** → [references/retention.md](references/retention.md)
144+- **Script feels clunky or confusing?** → [references/editing.md](references/editing.md)
added skills/youtube-scriptwriting/assets/script-template.md +101 -0
new file mode 100644
@@ -0,0 +1,101 @@
1+# YouTube Script Template
2+
3+## Pre-Script Planning
4+
5+**Target Audience**:
6+**Desired Emotion**:
7+**Core Promise**:
8+**Target Keyword**:
9+
10+## High-Shock Facts (5-10)
11+1.
12+2.
13+3.
14+4.
15+5.
16+
17+---
18+
19+## HOOK (0-15 seconds)
20+
21+**Hook Format Used**: [Secret Reveal / Case Study / Comparison / Question / Education / List / Contrarian / Personal Experience / Problem]
22+
23+[Write hook here - confirm click, open curiosity loop]
24+
25+---
26+
27+## BODY SECTION 1
28+
29+**Rehook**:
30+
31+**Content** (Context → Application → Framing):
32+
33+
34+
35+**Mini-Payoff**:
36+
37+---
38+
39+## BODY SECTION 2
40+
41+**Rehook**:
42+
43+**Content** (Context → Application → Framing):
44+
45+
46+
47+**Mini-Payoff**:
48+
49+---
50+
51+## BODY SECTION 3
52+
53+**Rehook**:
54+
55+**Content** (Context → Application → Framing):
56+
57+
58+
59+**Mini-Payoff**:
60+
61+---
62+
63+## OUTRO (Last 15-30 seconds)
64+
65+**Summary of Value**:
66+
67+**Binge Loop**:
68+- Link back to content:
69+- New problem/question:
70+- Promise (next video/resource):
71+
72+---
73+
74+## Pre-Publish Checklist
75+
76+### Hook Commandments
77+- [ ] Alignment: Visual + spoken + text hooks match
78+- [ ] Speed: Value promised in first 3 seconds
79+- [ ] Clarity: Topic is unmistakable
80+- [ ] Curiosity: Opens a question they must answer
81+
82+### Story Flow
83+- [ ] One clear through-line
84+- [ ] No unnecessary tangents
85+- [ ] Logical progression beginning → end
86+
87+### Comprehension
88+- [ ] 6th grade vocabulary
89+- [ ] Short, punchy sentences
90+- [ ] Active voice
91+- [ ] Complex ideas restated simply
92+
93+### Speed to Value
94+- [ ] Value in first 3 seconds
95+- [ ] Rehooks at proper intervals
96+- [ ] Each section has payoff
97+- [ ] Outro satisfies or extends
98+
99+### Emotion
100+- [ ] Target emotion achieved
101+- [ ] Emotional variety throughout
new file mode 100644
@@ -0,0 +1,101 @@
1+# YouTube Script Template
2+
3+## Pre-Script Planning
4+
5+**Target Audience**:
6+**Desired Emotion**:
7+**Core Promise**:
8+**Target Keyword**:
9+
10+## High-Shock Facts (5-10)
11+1.
12+2.
13+3.
14+4.
15+5.
16+
17+---
18+
19+## HOOK (0-15 seconds)
20+
21+**Hook Format Used**: [Secret Reveal / Case Study / Comparison / Question / Education / List / Contrarian / Personal Experience / Problem]
22+
23+[Write hook here - confirm click, open curiosity loop]
24+
25+---
26+
27+## BODY SECTION 1
28+
29+**Rehook**:
30+
31+**Content** (Context → Application → Framing):
32+
33+
34+
35+**Mini-Payoff**:
36+
37+---
38+
39+## BODY SECTION 2
40+
41+**Rehook**:
42+
43+**Content** (Context → Application → Framing):
44+
45+
46+
47+**Mini-Payoff**:
48+
49+---
50+
51+## BODY SECTION 3
52+
53+**Rehook**:
54+
55+**Content** (Context → Application → Framing):
56+
57+
58+
59+**Mini-Payoff**:
60+
61+---
62+
63+## OUTRO (Last 15-30 seconds)
64+
65+**Summary of Value**:
66+
67+**Binge Loop**:
68+- Link back to content:
69+- New problem/question:
70+- Promise (next video/resource):
71+
72+---
73+
74+## Pre-Publish Checklist
75+
76+### Hook Commandments
77+- [ ] Alignment: Visual + spoken + text hooks match
78+- [ ] Speed: Value promised in first 3 seconds
79+- [ ] Clarity: Topic is unmistakable
80+- [ ] Curiosity: Opens a question they must answer
81+
82+### Story Flow
83+- [ ] One clear through-line
84+- [ ] No unnecessary tangents
85+- [ ] Logical progression beginning → end
86+
87+### Comprehension
88+- [ ] 6th grade vocabulary
89+- [ ] Short, punchy sentences
90+- [ ] Active voice
91+- [ ] Complex ideas restated simply
92+
93+### Speed to Value
94+- [ ] Value in first 3 seconds
95+- [ ] Rehooks at proper intervals
96+- [ ] Each section has payoff
97+- [ ] Outro satisfies or extends
98+
99+### Emotion
100+- [ ] Target emotion achieved
101+- [ ] Emotional variety throughout
added skills/youtube-scriptwriting/references/editing.md +109 -0
new file mode 100644
@@ -0,0 +1,109 @@
1+# Editing & Quality Audits
2+
3+After your first draft, run these three audits before finalizing.
4+
5+## 1. Story Flow Audit
6+
7+**The Problem**: Too many tangents and unnecessary details break the viewer's hypnotic focus.
8+
9+**The Test**: Read each line and ask:
10+> "Is this line a necessary step in the logical flow, or is it a distraction/tangent?"
11+
12+**What to Look For**:
13+- Flashbacks or backstory that interrupt forward momentum
14+- Extra details that don't serve the main point
15+- "Red herrings" that confuse rather than clarify
16+- Broken plot lines (starting one thread, jumping to another, never returning)
17+
18+**The Sidewalk Analogy**: Every unnecessary detail is like throwing a barrel at someone walking down a sidewalk. It forces them to jump, react, and break their stride.
19+
20+**Fix**: Delete anything that breaks the through-line. Save it for another video.
21+
22+**Quality Check**: Can a viewer follow from beginning to end without getting lost? Is there ONE clear thread?
23+
24+## 2. Comprehension Audit
25+
26+**The Problem**: Viewers don't understand what you're saying, so they leave.
27+
28+**Goal**: Make viewers feel SMART, not dumb. Compress complex ideas into simple forms.
29+
30+### 5 Comprehension Fixes
31+
32+**1. Use simpler words**
33+- Target 6th grade vocabulary
34+- Claude/ChatGPT can rewrite at a simpler reading level in one click
35+- Big words only impress people who know them
36+
37+**2. Use fewer words (shorter sentences)**
38+- Weak attention spans + limited working memory
39+- More words per sentence = more cognitive load
40+- Quick. Short. Punchy. Staccato.
41+
42+**3. Use active voice**
43+- ✅ "The dog jumped"
44+- ❌ "The jumping was done by the dog"
45+- Active is clearer and more direct
46+
47+**4. Restate twice**
48+- First time: Normal explanation
49+- Second time: Simplest possible version
50+- Example: "This is called rudimentary—or simple—logic."
51+
52+**5. Name your frameworks**
53+- "Atomic Messaging" is easier to remember than "the practice of simplifying words for comprehension"
54+- A single-word label aids recall
55+- Make up names for your concepts
56+
57+### Distillation
58+
59+The skill of compressing complex ideas into simple language.
60+
61+**Why it's hard for experts**: They have big vocabularies and forget what beginners don't know. The muscle is "dumbing yourself down"—and it's trainable.
62+
63+## 3. Speed-to-Value Audit
64+
65+**The Problem**: Viewers aren't getting a hit of value fast enough before they bounce.
66+
67+**The Flow**:
68+```
69+Hook (0-3 sec): Signal incoming value
70+↓
71+First Body: Clear story flow
72+↓
73+Rehook (20-30 sec short-form, 2-3 min long-form): Re-trigger value
74+↓
75+Second Body: Clear story flow
76+↓
77+(Repeat rehook → body as needed)
78+↓
79+Outro: Summarize or extend value
80+```
81+
82+**Checklist**:
83+- [ ] Value is mentioned/teased in first 3 seconds
84+- [ ] First body section delivers on that tease
85+- [ ] Rehooks happen at appropriate intervals
86+- [ ] Each section has its own mini-payoff
87+- [ ] Outro leaves viewer feeling satisfied OR hungry for more
88+
89+## The Final Read-Through
90+
91+After all three audits, read the entire script aloud.
92+
93+**Ask yourself**:
94+1. Is this story interesting? (Would I keep watching?)
95+2. Is this as compressed as possible? (No fluff?)
96+3. Does this hook actually hook me? (Even on its own?)
97+4. What emotion do I feel when I finish? (Does it match my intended emotion?)
98+
99+If any answer is unsatisfying, revise and repeat.
100+
101+## Common Fixes Summary
102+
103+| Problem | Symptom | Fix |
104+|---------|---------|-----|
105+| Story flow | Viewer gets lost | Delete tangents, maintain one thread |
106+| Comprehension | Viewer feels dumb | Simpler words, shorter sentences, restate |
107+| Speed to value | Viewer bounces early | Hook value in 3 sec, rehook often |
108+| Monotony | Viewer zones out | Vary pacing, examples, emotions |
109+| Weak ending | Low engagement | Binge loop, summarize value, CTA |
new file mode 100644
@@ -0,0 +1,109 @@
1+# Editing & Quality Audits
2+
3+After your first draft, run these three audits before finalizing.
4+
5+## 1. Story Flow Audit
6+
7+**The Problem**: Too many tangents and unnecessary details break the viewer's hypnotic focus.
8+
9+**The Test**: Read each line and ask:
10+> "Is this line a necessary step in the logical flow, or is it a distraction/tangent?"
11+
12+**What to Look For**:
13+- Flashbacks or backstory that interrupt forward momentum
14+- Extra details that don't serve the main point
15+- "Red herrings" that confuse rather than clarify
16+- Broken plot lines (starting one thread, jumping to another, never returning)
17+
18+**The Sidewalk Analogy**: Every unnecessary detail is like throwing a barrel at someone walking down a sidewalk. It forces them to jump, react, and break their stride.
19+
20+**Fix**: Delete anything that breaks the through-line. Save it for another video.
21+
22+**Quality Check**: Can a viewer follow from beginning to end without getting lost? Is there ONE clear thread?
23+
24+## 2. Comprehension Audit
25+
26+**The Problem**: Viewers don't understand what you're saying, so they leave.
27+
28+**Goal**: Make viewers feel SMART, not dumb. Compress complex ideas into simple forms.
29+
30+### 5 Comprehension Fixes
31+
32+**1. Use simpler words**
33+- Target 6th grade vocabulary
34+- Claude/ChatGPT can rewrite at a simpler reading level in one click
35+- Big words only impress people who know them
36+
37+**2. Use fewer words (shorter sentences)**
38+- Weak attention spans + limited working memory
39+- More words per sentence = more cognitive load
40+- Quick. Short. Punchy. Staccato.
41+
42+**3. Use active voice**
43+- ✅ "The dog jumped"
44+- ❌ "The jumping was done by the dog"
45+- Active is clearer and more direct
46+
47+**4. Restate twice**
48+- First time: Normal explanation
49+- Second time: Simplest possible version
50+- Example: "This is called rudimentary—or simple—logic."
51+
52+**5. Name your frameworks**
53+- "Atomic Messaging" is easier to remember than "the practice of simplifying words for comprehension"
54+- A single-word label aids recall
55+- Make up names for your concepts
56+
57+### Distillation
58+
59+The skill of compressing complex ideas into simple language.
60+
61+**Why it's hard for experts**: They have big vocabularies and forget what beginners don't know. The muscle is "dumbing yourself down"—and it's trainable.
62+
63+## 3. Speed-to-Value Audit
64+
65+**The Problem**: Viewers aren't getting a hit of value fast enough before they bounce.
66+
67+**The Flow**:
68+```
69+Hook (0-3 sec): Signal incoming value
70+↓
71+First Body: Clear story flow
72+↓
73+Rehook (20-30 sec short-form, 2-3 min long-form): Re-trigger value
74+↓
75+Second Body: Clear story flow
76+↓
77+(Repeat rehook → body as needed)
78+↓
79+Outro: Summarize or extend value
80+```
81+
82+**Checklist**:
83+- [ ] Value is mentioned/teased in first 3 seconds
84+- [ ] First body section delivers on that tease
85+- [ ] Rehooks happen at appropriate intervals
86+- [ ] Each section has its own mini-payoff
87+- [ ] Outro leaves viewer feeling satisfied OR hungry for more
88+
89+## The Final Read-Through
90+
91+After all three audits, read the entire script aloud.
92+
93+**Ask yourself**:
94+1. Is this story interesting? (Would I keep watching?)
95+2. Is this as compressed as possible? (No fluff?)
96+3. Does this hook actually hook me? (Even on its own?)
97+4. What emotion do I feel when I finish? (Does it match my intended emotion?)
98+
99+If any answer is unsatisfying, revise and repeat.
100+
101+## Common Fixes Summary
102+
103+| Problem | Symptom | Fix |
104+|---------|---------|-----|
105+| Story flow | Viewer gets lost | Delete tangents, maintain one thread |
106+| Comprehension | Viewer feels dumb | Simpler words, shorter sentences, restate |
107+| Speed to value | Viewer bounces early | Hook value in 3 sec, rehook often |
108+| Monotony | Viewer zones out | Vary pacing, examples, emotions |
109+| Weak ending | Low engagement | Binge loop, summarize value, CTA |
added skills/youtube-scriptwriting/references/hooks.md +112 -0
new file mode 100644
@@ -0,0 +1,112 @@
1+# Hook Formats
2+
3+The hook has two jobs:
4+1. **Confirm the click** - Match expectations set by title/thumbnail
5+2. **Open a curiosity loop** - Create a question they must stay to answer
6+
7+## The 9 Proven Hook Formats
8+
9+### 1. Secret Reveal
10+Tease unknown insight or future implication.
11+
12+> "Google just released four free AI trainings that make it way faster to learn AI."
13+
14+**Best for**: News, product releases, tactical tips just uncovered
15+
16+### 2. Case Study
17+Highlight a person/brand that achieved a result in an unexpected way.
18+
19+> "Alex Hormozi just sold $100 million worth of books in 3 days using this five-step method."
20+
21+**Best for**: Breaking down how X accomplished Y using Z method
22+
23+### 3. Comparison
24+Compare two versions to illustrate optimal vs suboptimal.
25+
26+> "What's the difference between a beginner creator and an experienced one?"
27+
28+**Best for**: A vs B scenarios, before/after contrasts
29+
30+### 4. Question
31+Ask a question to implant curiosity directly.
32+
33+> "Can you bake sourdough bread in under an hour using only household ingredients?"
34+
35+**Best for**: Challenge videos, addressing common viewer questions
36+
37+### 5. Education
38+Introduce a step-by-step process.
39+
40+> "Here's the easiest way to use ChatGPT to create content."
41+
42+**Best for**: Tutorials, playbooks, how-to content
43+
44+### 6. List
45+Introduce an ordered set of items.
46+
47+> "These are the five best Premiere Pro editing templates that you can use for free."
48+
49+**Best for**: Rapid-fire lists, top X videos
50+
51+### 7. Contrarian
52+Introduce a bold take that goes against the grain.
53+
54+> "Jaguar's rebrand is one of the worst design blunders in the history of the world."
55+
56+**Best for**: Opinion pieces, hot takes that spark discussion
57+
58+### 8. Personal Experience
59+Introduce a personal story.
60+
61+> "When I was in college, I used this sleep technique to only sleep 3 hours per night."
62+
63+**Best for**: First-person storytelling, transformation narratives
64+
65+### 9. Problem
66+Introduce a specific pain point to set up a solution.
67+
68+> "If you struggle with acne, this is one obvious solution that will clear it right up."
69+
70+**Best for**: Leading with pain, then delivering solution
71+
72+## Hook Psychology: The PAS Framework
73+
74+**P**roblem → **A**gitate → **S**olution (tease)
75+
76+1. Call out a burning pain point
77+2. Stir emotion around the pain
78+3. Tease your unique solution
79+
80+**Example**:
81+> "If you're struggling with how to write a viral YouTube script [PROBLEM] and you're feeling overwhelmed with where to even start [AGITATE], then I have some exciting news. I've discovered a simple seven-step framework that's helped me produce over 7 million views [SOLUTION TEASE]."
82+
83+## Hook Psychology: The AIDA Framework
84+
85+**A**ttention → **I**nterest → **D**esire → **D**elay
86+
87+1. Burning question grabs attention
88+2. Tease unique solution to peak interest
89+3. Promise result to increase desire
90+4. Delay the solution to force continued watching
91+
92+**Example**:
93+> "Have you ever wondered why plain boring thumbnails sometimes generate millions of views? [ATTENTION] You might have heard people say it's because it's simple. But what if I told you it's got nothing to do with simplicity—it's actually caused by something called a curiosity gap [INTEREST]. Once you understand how to create them, you'll notice a massive increase in your click-through rate [DESIRE]. But just before I reveal how it works, I want to start by explaining... [DELAY]"
94+
95+## The 4 Hook Commandments
96+
97+Before finalizing your hook, verify:
98+
99+1. **Alignment**: Visual hook + spoken hook + text hook all match
100+2. **Speed to Value**: Value promised in first 3 seconds
101+3. **Clarity**: Topic is unmistakably clear
102+4. **Curiosity**: Opens a question viewer must answer
103+
104+## Hook Formula (Universal)
105+
106+**Target + Transformation + Stakes**
107+
108+- **Target**: Who am I speaking to?
109+- **Transformation**: What will they learn/gain?
110+- **Stakes**: What happens if they don't watch?
111+
112+Write these three components separately, then combine into a working hook.
new file mode 100644
@@ -0,0 +1,112 @@
1+# Hook Formats
2+
3+The hook has two jobs:
4+1. **Confirm the click** - Match expectations set by title/thumbnail
5+2. **Open a curiosity loop** - Create a question they must stay to answer
6+
7+## The 9 Proven Hook Formats
8+
9+### 1. Secret Reveal
10+Tease unknown insight or future implication.
11+
12+> "Google just released four free AI trainings that make it way faster to learn AI."
13+
14+**Best for**: News, product releases, tactical tips just uncovered
15+
16+### 2. Case Study
17+Highlight a person/brand that achieved a result in an unexpected way.
18+
19+> "Alex Hormozi just sold $100 million worth of books in 3 days using this five-step method."
20+
21+**Best for**: Breaking down how X accomplished Y using Z method
22+
23+### 3. Comparison
24+Compare two versions to illustrate optimal vs suboptimal.
25+
26+> "What's the difference between a beginner creator and an experienced one?"
27+
28+**Best for**: A vs B scenarios, before/after contrasts
29+
30+### 4. Question
31+Ask a question to implant curiosity directly.
32+
33+> "Can you bake sourdough bread in under an hour using only household ingredients?"
34+
35+**Best for**: Challenge videos, addressing common viewer questions
36+
37+### 5. Education
38+Introduce a step-by-step process.
39+
40+> "Here's the easiest way to use ChatGPT to create content."
41+
42+**Best for**: Tutorials, playbooks, how-to content
43+
44+### 6. List
45+Introduce an ordered set of items.
46+
47+> "These are the five best Premiere Pro editing templates that you can use for free."
48+
49+**Best for**: Rapid-fire lists, top X videos
50+
51+### 7. Contrarian
52+Introduce a bold take that goes against the grain.
53+
54+> "Jaguar's rebrand is one of the worst design blunders in the history of the world."
55+
56+**Best for**: Opinion pieces, hot takes that spark discussion
57+
58+### 8. Personal Experience
59+Introduce a personal story.
60+
61+> "When I was in college, I used this sleep technique to only sleep 3 hours per night."
62+
63+**Best for**: First-person storytelling, transformation narratives
64+
65+### 9. Problem
66+Introduce a specific pain point to set up a solution.
67+
68+> "If you struggle with acne, this is one obvious solution that will clear it right up."
69+
70+**Best for**: Leading with pain, then delivering solution
71+
72+## Hook Psychology: The PAS Framework
73+
74+**P**roblem → **A**gitate → **S**olution (tease)
75+
76+1. Call out a burning pain point
77+2. Stir emotion around the pain
78+3. Tease your unique solution
79+
80+**Example**:
81+> "If you're struggling with how to write a viral YouTube script [PROBLEM] and you're feeling overwhelmed with where to even start [AGITATE], then I have some exciting news. I've discovered a simple seven-step framework that's helped me produce over 7 million views [SOLUTION TEASE]."
82+
83+## Hook Psychology: The AIDA Framework
84+
85+**A**ttention → **I**nterest → **D**esire → **D**elay
86+
87+1. Burning question grabs attention
88+2. Tease unique solution to peak interest
89+3. Promise result to increase desire
90+4. Delay the solution to force continued watching
91+
92+**Example**:
93+> "Have you ever wondered why plain boring thumbnails sometimes generate millions of views? [ATTENTION] You might have heard people say it's because it's simple. But what if I told you it's got nothing to do with simplicity—it's actually caused by something called a curiosity gap [INTEREST]. Once you understand how to create them, you'll notice a massive increase in your click-through rate [DESIRE]. But just before I reveal how it works, I want to start by explaining... [DELAY]"
94+
95+## The 4 Hook Commandments
96+
97+Before finalizing your hook, verify:
98+
99+1. **Alignment**: Visual hook + spoken hook + text hook all match
100+2. **Speed to Value**: Value promised in first 3 seconds
101+3. **Clarity**: Topic is unmistakably clear
102+4. **Curiosity**: Opens a question viewer must answer
103+
104+## Hook Formula (Universal)
105+
106+**Target + Transformation + Stakes**
107+
108+- **Target**: Who am I speaking to?
109+- **Transformation**: What will they learn/gain?
110+- **Stakes**: What happens if they don't watch?
111+
112+Write these three components separately, then combine into a working hook.
added skills/youtube-scriptwriting/references/research.md +74 -0
new file mode 100644
@@ -0,0 +1,74 @@
1+# Research & Idea Development
2+
3+## Audience Research
4+
5+Before writing, know exactly who you're speaking to.
6+
7+**Key Questions**:
8+- What pains, desires, dreams, goals does this audience have?
9+- What do they already believe about this topic?
10+- What have they already heard/seen on this topic?
11+
12+**AI Research Method**:
13+1. Find top 3 competitors in your niche
14+2. Extract transcripts from their top-performing videos (last 12 months)
15+3. Feed transcripts to Claude/ChatGPT
16+4. Ask: "What pain points does this audience have?" "What topics resonated?" "What beliefs do they hold?"
17+
18+## Content Research: The Shock Score Method
19+
20+**Goal**: Find facts that maximize the gap between what viewers know and what you'll tell them.
21+
22+**Process**:
23+1. Consume source material (videos, articles, research, personal experience)
24+2. For each fact/insight, rate its Shock Score 1-100:
25+ - "Out of 100 viewers, how many would NOT have heard this before?"
26+ - 80+ = Must include (high shock)
27+ - 50-79 = Good supporting point
28+ - Below 50 = Skip unless essential context
29+
30+**Where to Find High-Shock Facts**:
31+- Most-replayed sections of competitor videos (scrub timeline for peaks)
32+- Comments praising specific insights
33+- Academic research/studies
34+- Expert interviews
35+- Personal experience/experiments
36+- Contrarian takes on conventional wisdom
37+
38+**Red Flags** (low shock, skip these):
39+- Information on first page of Google
40+- Advice repeated in every video on the topic
41+- Obvious common sense
42+
43+## Keyword Research for SEO
44+
45+**Tools**: VidIQ, TubeBuddy, YouTube Search Suggest
46+
47+**Process**:
48+1. Type topic into YouTube search, note autocomplete suggestions
49+2. Check search volume and competition in VidIQ/TubeBuddy
50+3. Look for high-volume, low-competition phrases
51+4. Integrate target keyword into: Title, Description, Tags, Spoken hook
52+
53+**Title Optimization**:
54+- Front-load the keyword
55+- Create curiosity gap
56+- Under 60 characters (doesn't get cut off)
57+
58+## Output: Research Document
59+
60+Before moving to scripting, you should have:
61+
62+```
63+TARGET AUDIENCE: [Who specifically]
64+DESIRED EMOTION: [One primary emotion]
65+CORE PROMISE: [One sentence value proposition]
66+
67+HIGH-SHOCK FACTS (5-10 bullets, shock score 80+):
68+- Fact 1
69+- Fact 2
70+- ...
71+
72+TARGET KEYWORD: [Primary search term]
73+TITLE OPTIONS: [2-3 working titles]
74+```
new file mode 100644
@@ -0,0 +1,74 @@
1+# Research & Idea Development
2+
3+## Audience Research
4+
5+Before writing, know exactly who you're speaking to.
6+
7+**Key Questions**:
8+- What pains, desires, dreams, goals does this audience have?
9+- What do they already believe about this topic?
10+- What have they already heard/seen on this topic?
11+
12+**AI Research Method**:
13+1. Find top 3 competitors in your niche
14+2. Extract transcripts from their top-performing videos (last 12 months)
15+3. Feed transcripts to Claude/ChatGPT
16+4. Ask: "What pain points does this audience have?" "What topics resonated?" "What beliefs do they hold?"
17+
18+## Content Research: The Shock Score Method
19+
20+**Goal**: Find facts that maximize the gap between what viewers know and what you'll tell them.
21+
22+**Process**:
23+1. Consume source material (videos, articles, research, personal experience)
24+2. For each fact/insight, rate its Shock Score 1-100:
25+ - "Out of 100 viewers, how many would NOT have heard this before?"
26+ - 80+ = Must include (high shock)
27+ - 50-79 = Good supporting point
28+ - Below 50 = Skip unless essential context
29+
30+**Where to Find High-Shock Facts**:
31+- Most-replayed sections of competitor videos (scrub timeline for peaks)
32+- Comments praising specific insights
33+- Academic research/studies
34+- Expert interviews
35+- Personal experience/experiments
36+- Contrarian takes on conventional wisdom
37+
38+**Red Flags** (low shock, skip these):
39+- Information on first page of Google
40+- Advice repeated in every video on the topic
41+- Obvious common sense
42+
43+## Keyword Research for SEO
44+
45+**Tools**: VidIQ, TubeBuddy, YouTube Search Suggest
46+
47+**Process**:
48+1. Type topic into YouTube search, note autocomplete suggestions
49+2. Check search volume and competition in VidIQ/TubeBuddy
50+3. Look for high-volume, low-competition phrases
51+4. Integrate target keyword into: Title, Description, Tags, Spoken hook
52+
53+**Title Optimization**:
54+- Front-load the keyword
55+- Create curiosity gap
56+- Under 60 characters (doesn't get cut off)
57+
58+## Output: Research Document
59+
60+Before moving to scripting, you should have:
61+
62+```
63+TARGET AUDIENCE: [Who specifically]
64+DESIRED EMOTION: [One primary emotion]
65+CORE PROMISE: [One sentence value proposition]
66+
67+HIGH-SHOCK FACTS (5-10 bullets, shock score 80+):
68+- Fact 1
69+- Fact 2
70+- ...
71+
72+TARGET KEYWORD: [Primary search term]
73+TITLE OPTIONS: [2-3 working titles]
74+```
added skills/youtube-scriptwriting/references/retention.md +108 -0
new file mode 100644
@@ -0,0 +1,108 @@
1+# Retention Techniques
2+
3+## The Psychology of Retention
4+
5+Viewer attention is a decaying resource. The moment they click, attention is at maximum. It declines unless you actively reset it.
6+
7+**Attention Pattern**:
8+```
9+New section starts → Attention HIGH
10+↓
11+Content continues → Attention DECAYS
12+↓
13+Rehook → Attention RESETS
14+↓
15+(Repeat)
16+```
17+
18+## Rehooks
19+
20+A rehook is a mini-hook between sections that resets attention.
21+
22+**Timing**: Every 30-60 seconds for short-form, every 2-3 minutes for long-form
23+
24+**Purpose**: Reagitate the promise, tease upcoming value
25+
26+### The Problem-Desire-Delay Formula
27+
28+1. **Problem**: Call out a deep pain point related to next section
29+2. **Desire**: Agitate + tease the solution
30+3. **Delay**: "But first..." or "Before I reveal..."
31+
32+**Example**:
33+> "The average person has zero idea how fat loss works, which leads to constant yo-yo dieting and heartbreak. [PROBLEM + AGITATE] But how does the body actually release fat, and how can you use this knowledge to finally see results? [DESIRE] Well, to understand this, I first have to explain... [DELAY]"
34+
35+### Simple Rehook Phrases
36+
37+- "But here's where it gets interesting..."
38+- "And that's just the beginning..."
39+- "But if you don't do this next step, everything else falls apart..."
40+- "Now this is where most people mess up..."
41+- "But wait, there's something even more important..."
42+
43+## Setups and Payoffs
44+
45+**Setup**: Plant a question or tease information
46+**Payoff**: Deliver the answer or reveal
47+
48+The gap between setup and payoff creates TENSION. Tension = retention.
49+
50+### The Rule of Second-Best First
51+
52+**Counterintuitive insight**: Put your SECOND-BEST point first, BEST point second.
53+
54+**Why it works**:
55+- Point 1 is great → viewer thinks "nice"
56+- Point 2 is even better → pattern recognition: "value is increasing"
57+- Viewer assumes Point 3+ will continue ascending → stays to see
58+
59+If you lead with your best and go downhill, viewers subconsciously sense diminishing returns and leave.
60+
61+**This is why hit songs are often Track 3-4 on albums, not Track 1.**
62+
63+## The Value Loop
64+
65+For each point in your body, cycle through:
66+
67+1. **Context**: What is it? (Simple, clear definition)
68+2. **Application**: How do you use it? (Examples, demonstrations)
69+3. **Framing**: Why does it matter? (Connect to bigger picture, zoom out)
70+
71+This pattern matches how brains process information: surface → depth → integration.
72+
73+## Emotional Variety
74+
75+Monotone = boring. Vary the emotional texture throughout.
76+
77+**Techniques**:
78+- Mix humor with serious points
79+- Alternate tension and relief
80+- Use surprise/twist moments
81+- Wave between zoomed-in (detail) and zoomed-out (big picture)
82+- Change pacing: fast sections followed by slower, reflective moments
83+
84+**Rule of thumb**: Change something every 30-40 seconds—new example, rehook, question, visual shift.
85+
86+## The Binge Loop (Outro)
87+
88+The last 15-30 seconds should loop viewers to your next video.
89+
90+**Formula**:
91+1. **Link back**: Naturally tie to what you just covered
92+2. **New problem**: Introduce a fresh question/pain
93+3. **Promise**: Tease the solution in another video
94+
95+**Example**:
96+> "And what I love about these techniques is they prove that becoming a great YouTuber isn't about being a natural showman—it's about developing skills. [LINK BACK] But that takes time. And even when you've mastered communication, that alone won't grow your channel. You have to think outside the box. [NEW PROBLEM] But how do you do that? Click this video, because next you're going to combine these retention hacks with viral storytelling techniques... [PROMISE]"
97+
98+## Click Confirmation
99+
100+In the first 3-5 seconds, CONFIRM the promise of your title/thumbnail.
101+
102+**If title says**: "I spent 100 hours inside the pyramids"
103+**First line must**: Show/tell that you're in the pyramids
104+
105+**To EXCEED expectations**: Add something extra
106+> "I spent 100 hours inside the pyramids... and I have unprecedented access to explore areas that have never been filmed before."
107+
108+This positive gap (reality > expectations) hooks the viewer immediately.
new file mode 100644
@@ -0,0 +1,108 @@
1+# Retention Techniques
2+
3+## The Psychology of Retention
4+
5+Viewer attention is a decaying resource. The moment they click, attention is at maximum. It declines unless you actively reset it.
6+
7+**Attention Pattern**:
8+```
9+New section starts → Attention HIGH
10+↓
11+Content continues → Attention DECAYS
12+↓
13+Rehook → Attention RESETS
14+↓
15+(Repeat)
16+```
17+
18+## Rehooks
19+
20+A rehook is a mini-hook between sections that resets attention.
21+
22+**Timing**: Every 30-60 seconds for short-form, every 2-3 minutes for long-form
23+
24+**Purpose**: Reagitate the promise, tease upcoming value
25+
26+### The Problem-Desire-Delay Formula
27+
28+1. **Problem**: Call out a deep pain point related to next section
29+2. **Desire**: Agitate + tease the solution
30+3. **Delay**: "But first..." or "Before I reveal..."
31+
32+**Example**:
33+> "The average person has zero idea how fat loss works, which leads to constant yo-yo dieting and heartbreak. [PROBLEM + AGITATE] But how does the body actually release fat, and how can you use this knowledge to finally see results? [DESIRE] Well, to understand this, I first have to explain... [DELAY]"
34+
35+### Simple Rehook Phrases
36+
37+- "But here's where it gets interesting..."
38+- "And that's just the beginning..."
39+- "But if you don't do this next step, everything else falls apart..."
40+- "Now this is where most people mess up..."
41+- "But wait, there's something even more important..."
42+
43+## Setups and Payoffs
44+
45+**Setup**: Plant a question or tease information
46+**Payoff**: Deliver the answer or reveal
47+
48+The gap between setup and payoff creates TENSION. Tension = retention.
49+
50+### The Rule of Second-Best First
51+
52+**Counterintuitive insight**: Put your SECOND-BEST point first, BEST point second.
53+
54+**Why it works**:
55+- Point 1 is great → viewer thinks "nice"
56+- Point 2 is even better → pattern recognition: "value is increasing"
57+- Viewer assumes Point 3+ will continue ascending → stays to see
58+
59+If you lead with your best and go downhill, viewers subconsciously sense diminishing returns and leave.
60+
61+**This is why hit songs are often Track 3-4 on albums, not Track 1.**
62+
63+## The Value Loop
64+
65+For each point in your body, cycle through:
66+
67+1. **Context**: What is it? (Simple, clear definition)
68+2. **Application**: How do you use it? (Examples, demonstrations)
69+3. **Framing**: Why does it matter? (Connect to bigger picture, zoom out)
70+
71+This pattern matches how brains process information: surface → depth → integration.
72+
73+## Emotional Variety
74+
75+Monotone = boring. Vary the emotional texture throughout.
76+
77+**Techniques**:
78+- Mix humor with serious points
79+- Alternate tension and relief
80+- Use surprise/twist moments
81+- Wave between zoomed-in (detail) and zoomed-out (big picture)
82+- Change pacing: fast sections followed by slower, reflective moments
83+
84+**Rule of thumb**: Change something every 30-40 seconds—new example, rehook, question, visual shift.
85+
86+## The Binge Loop (Outro)
87+
88+The last 15-30 seconds should loop viewers to your next video.
89+
90+**Formula**:
91+1. **Link back**: Naturally tie to what you just covered
92+2. **New problem**: Introduce a fresh question/pain
93+3. **Promise**: Tease the solution in another video
94+
95+**Example**:
96+> "And what I love about these techniques is they prove that becoming a great YouTuber isn't about being a natural showman—it's about developing skills. [LINK BACK] But that takes time. And even when you've mastered communication, that alone won't grow your channel. You have to think outside the box. [NEW PROBLEM] But how do you do that? Click this video, because next you're going to combine these retention hacks with viral storytelling techniques... [PROMISE]"
97+
98+## Click Confirmation
99+
100+In the first 3-5 seconds, CONFIRM the promise of your title/thumbnail.
101+
102+**If title says**: "I spent 100 hours inside the pyramids"
103+**First line must**: Show/tell that you're in the pyramids
104+
105+**To EXCEED expectations**: Add something extra
106+> "I spent 100 hours inside the pyramids... and I have unprecedented access to explore areas that have never been filmed before."
107+
108+This positive gap (reality > expectations) hooks the viewer immediately.
added skills/youtube-scriptwriting/references/structures.md +171 -0
new file mode 100644
@@ -0,0 +1,171 @@
1+# Story Structures
2+
3+Choose ONE structure that fits your content. Don't overcomplicate—pick what's already working in your niche.
4+
5+## The 7 Proven Story Structures
6+
7+### 1. Breakdown
8+Explain a complex concept in building blocks.
9+
10+**Outline**:
11+```
12+Hook
13+↓
14+Initial Context + Shock
15+↓
16+Block 1: What happened / How it works
17+↓
18+Block 2: Why it matters
19+↓
20+Outro
21+```
22+
23+**Best for**: Product launches, news, technology analysis
24+**Pair with hooks**: Secret Reveal, Question, Comparison, Contrarian
25+
26+### 2. Newscaster
27+Factual recounting of an event (journalist style).
28+
29+**Outline**:
30+```
31+Hook
32+↓
33+Full Context of Story
34+↓
35+(Optional) Brief Analysis/Take
36+↓
37+Outro
38+```
39+
40+**Best for**: News coverage, journalism, updates
41+**Pair with hooks**: Secret Reveal, Question, Comparison, Contrarian, Problem
42+
43+### 3. Case Study Explainer
44+Teach a framework/process that achieved an outcome.
45+
46+**Outline**:
47+```
48+Hook
49+↓
50+Framework Piece 1
51+↓
52+Framework Piece 2
53+↓
54+Framework Piece 3-4
55+↓
56+Outro
57+```
58+
59+**Best for**: Teaching skills, breaking down frameworks
60+**Pair with hooks**: Case Study, Question, Comparison
61+
62+### 4. Listicle
63+Ordered list of items.
64+
65+**Outline**:
66+```
67+Hook
68+↓
69+Item 1
70+↓
71+Item 2
72+↓
73+Item 3-5
74+↓
75+Outro
76+```
77+
78+**Best for**: Mutually exclusive items that can stand alone
79+**Pair with hooks**: List, Problem
80+
81+### 5. Problem-Solver
82+Agitate a pain, deliver a solution.
83+
84+**Outline**:
85+```
86+Hook
87+↓
88+Problem (agitate)
89+↓
90+Solution
91+↓
92+Outro
93+```
94+
95+**Best for**: Leading with pain, product/service content
96+**Pair with hooks**: Problem, Question, Contrarian
97+
98+### 6. Tutorial
99+Step-by-step walkthrough of a system.
100+
101+**Outline**:
102+```
103+Hook
104+↓
105+Step 1
106+↓
107+Step 2
108+↓
109+Step 3+
110+↓
111+Outro
112+```
113+
114+**Best for**: How-to content, walkthroughs, experiments
115+**Pair with hooks**: Education, Question
116+
117+**Note**: Tutorial steps are CONTINGENT (each builds on previous). Listicle items are INDEPENDENT (each stands alone).
118+
119+### 7. Educational / Personal Story
120+First-person narrative with lessons.
121+
122+**Outline**:
123+```
124+Hook
125+↓
126+Story Beginning
127+↓
128+Story Middle (conflict)
129+↓
130+Story End (resolution)
131+↓
132+Lesson/Takeaway
133+↓
134+Outro
135+```
136+
137+**Best for**: Motivation, inspiration, personal transformation
138+**Pair with hooks**: Personal Experience, Problem, Contrarian
139+
140+## Choosing the Right Structure
141+
142+1. **Look at what's working**: Study top videos in your niche. What structure do they use?
143+2. **Match to content type**:
144+ - Teaching a process → Tutorial or Case Study
145+ - Sharing a list of things → Listicle
146+ - Telling your story → Personal/Educational
147+ - Covering news → Newscaster or Breakdown
148+ - Solving a problem → Problem-Solver
149+
150+## The "But-Therefore" Storytelling Method
151+
152+Make stories engaging by using conflict transitions:
153+
154+❌ Boring: "I did this. Then I did that. Then I did this."
155+✅ Engaging: "I did this. **But** then this happened. **Therefore** I had to do this."
156+
157+"But" introduces conflict.
158+"Therefore" shows consequence.
159+
160+**Example**:
161+> "I went on a walk. **But** it started raining. **Therefore** I started running back home."
162+
163+## The 3A Story Framework
164+
165+For any story segment:
166+
167+1. **Beginning**: Set the scene, give context
168+2. **Challenge**: Introduce conflict (the "but")
169+3. **Consequence**: Show what happened as a result (the "therefore")
170+
171+This creates tension and resolution in every section, not just the overall video.
new file mode 100644
@@ -0,0 +1,171 @@
1+# Story Structures
2+
3+Choose ONE structure that fits your content. Don't overcomplicate—pick what's already working in your niche.
4+
5+## The 7 Proven Story Structures
6+
7+### 1. Breakdown
8+Explain a complex concept in building blocks.
9+
10+**Outline**:
11+```
12+Hook
13+↓
14+Initial Context + Shock
15+↓
16+Block 1: What happened / How it works
17+↓
18+Block 2: Why it matters
19+↓
20+Outro
21+```
22+
23+**Best for**: Product launches, news, technology analysis
24+**Pair with hooks**: Secret Reveal, Question, Comparison, Contrarian
25+
26+### 2. Newscaster
27+Factual recounting of an event (journalist style).
28+
29+**Outline**:
30+```
31+Hook
32+↓
33+Full Context of Story
34+↓
35+(Optional) Brief Analysis/Take
36+↓
37+Outro
38+```
39+
40+**Best for**: News coverage, journalism, updates
41+**Pair with hooks**: Secret Reveal, Question, Comparison, Contrarian, Problem
42+
43+### 3. Case Study Explainer
44+Teach a framework/process that achieved an outcome.
45+
46+**Outline**:
47+```
48+Hook
49+↓
50+Framework Piece 1
51+↓
52+Framework Piece 2
53+↓
54+Framework Piece 3-4
55+↓
56+Outro
57+```
58+
59+**Best for**: Teaching skills, breaking down frameworks
60+**Pair with hooks**: Case Study, Question, Comparison
61+
62+### 4. Listicle
63+Ordered list of items.
64+
65+**Outline**:
66+```
67+Hook
68+↓
69+Item 1
70+↓
71+Item 2
72+↓
73+Item 3-5
74+↓
75+Outro
76+```
77+
78+**Best for**: Mutually exclusive items that can stand alone
79+**Pair with hooks**: List, Problem
80+
81+### 5. Problem-Solver
82+Agitate a pain, deliver a solution.
83+
84+**Outline**:
85+```
86+Hook
87+↓
88+Problem (agitate)
89+↓
90+Solution
91+↓
92+Outro
93+```
94+
95+**Best for**: Leading with pain, product/service content
96+**Pair with hooks**: Problem, Question, Contrarian
97+
98+### 6. Tutorial
99+Step-by-step walkthrough of a system.
100+
101+**Outline**:
102+```
103+Hook
104+↓
105+Step 1
106+↓
107+Step 2
108+↓
109+Step 3+
110+↓
111+Outro
112+```
113+
114+**Best for**: How-to content, walkthroughs, experiments
115+**Pair with hooks**: Education, Question
116+
117+**Note**: Tutorial steps are CONTINGENT (each builds on previous). Listicle items are INDEPENDENT (each stands alone).
118+
119+### 7. Educational / Personal Story
120+First-person narrative with lessons.
121+
122+**Outline**:
123+```
124+Hook
125+↓
126+Story Beginning
127+↓
128+Story Middle (conflict)
129+↓
130+Story End (resolution)
131+↓
132+Lesson/Takeaway
133+↓
134+Outro
135+```
136+
137+**Best for**: Motivation, inspiration, personal transformation
138+**Pair with hooks**: Personal Experience, Problem, Contrarian
139+
140+## Choosing the Right Structure
141+
142+1. **Look at what's working**: Study top videos in your niche. What structure do they use?
143+2. **Match to content type**:
144+ - Teaching a process → Tutorial or Case Study
145+ - Sharing a list of things → Listicle
146+ - Telling your story → Personal/Educational
147+ - Covering news → Newscaster or Breakdown
148+ - Solving a problem → Problem-Solver
149+
150+## The "But-Therefore" Storytelling Method
151+
152+Make stories engaging by using conflict transitions:
153+
154+❌ Boring: "I did this. Then I did that. Then I did this."
155+✅ Engaging: "I did this. **But** then this happened. **Therefore** I had to do this."
156+
157+"But" introduces conflict.
158+"Therefore" shows consequence.
159+
160+**Example**:
161+> "I went on a walk. **But** it started raining. **Therefore** I started running back home."
162+
163+## The 3A Story Framework
164+
165+For any story segment:
166+
167+1. **Beginning**: Set the scene, give context
168+2. **Challenge**: Introduce conflict (the "but")
169+3. **Consequence**: Show what happened as a result (the "therefore")
170+
171+This creates tension and resolution in every section, not just the overall video.
added skills/youtube-thumbnail/SKILL.md +97 -0
new file mode 100644
@@ -0,0 +1,97 @@
1+---
2+name: youtube-thumbnail
3+description: Proposer des compositions de vignettes YouTube avant de les générer — scène, texte, couleurs, et la curiosité que chacune crée. À utiliser quand il faut imaginer ou critiquer une vignette, ou rédiger ce qu'un modèle d'image doit dessiner.
4+---
5+
6+# Composer une vignette YouTube
7+
8+Une vignette n'illustre pas la vidéo : elle crée une question que seul le clic résout. Le titre
9+et la vignette travaillent ensemble — l'un ne répète jamais l'autre.
10+
11+Ce skill sert à **proposer des compositions** avant toute génération d'image. Une composition,
12+c'est : ce que montre l'image (la scène), le texte éventuel, deux ou trois couleurs, et en une
13+phrase la question qu'elle pose au spectateur.
14+
15+## Les deux exigences qui priment
16+
17+1. **La curiosité.** La vignette ouvre une tension : un avant/après, un objet inattendu, une
18+ émotion forte face à quelque chose qu'on ne voit qu'à moitié, un chiffre qui choque. Sans
19+ tension, tout le reste est inutile.
20+2. **Le test du coup d'œil.** Comprise en une seconde, à la taille d'un téléphone (environ
21+ 280 × 157 px). Si l'œil doit chercher, c'est raté.
22+
23+Tout le reste sert ces deux exigences.
24+
25+## Règles de composition
26+
27+- **Un point focal, deux au maximum.** Au-delà de trois éléments distincts, l'image devient
28+ bruit. Un élément domine nettement.
29+- **Simple et aéré** : un tiers de l'image environ reste vide (fond uni, flou, dégradé).
30+- **Contraste fort** : sujet clair sur fond sombre ou l'inverse ; couleurs franches (rouge,
31+ jaune, orange, cyan) ; deux ou trois couleurs, pas plus.
32+- **Hiérarchie** : texte, puis visage, puis objet ou logo, puis fond.
33+- **Pensé pour le mobile** : rien de petit ni de fin ; pas de détail qui ne compte qu'en grand.
34+
35+## Le visage
36+
37+- Un visage expressif attire plus qu'une scène sans personne. L'expression n'est jamais
38+ neutre : surprise, incrédulité, inquiétude, amusement, colère contenue — une émotion mêlée
39+ vaut souvent mieux qu'une émotion simple.
40+- **Le regard dirige l'attention** : face caméra, il crée le lien ; tourné vers l'objet, il y
41+ emmène l'œil du spectateur.
42+- Visage grand (30 à 50 % du cadre), plutôt d'un côté, l'élément focal de l'autre.
43+- Une seule personne, deux au plus.
44+
45+## Le texte
46+
47+- **0 à 3 mots**, 5 au grand maximum. Pas de texte du tout est une option valable.
48+- **Il complète le titre, il ne le répète pas** : il ajoute un chiffre, une réaction, un
49+ verdict, l'enjeu (« 54 % GONE », « TROP TARD », « ÇA MARCHE ? »).
50+- Gros, gras, condensé, en capitales, avec un contour ou un aplat pour rester lisible.
51+- Placé en haut à gauche ou au centre ; jamais en bas à droite.
52+
53+## Zones à éviter
54+
55+- **Bas à droite** : la durée de la vidéo s'y affiche. Jamais rien d'important.
56+- **Bord bas** : la barre de progression.
57+- Marges d'environ 8 % sur les côtés et 10 % en haut et en bas.
58+
59+## Logos et objets réels
60+
61+Un logo d'outil ou de marque reconnaissable sert de badge (« ça parle de ça »). Mais un modèle
62+d'image ne sait pas dessiner un logo fidèlement : si la composition en a besoin, dis-le pour
63+que l'auteur fournisse l'image, plutôt que de compter sur le modèle.
64+
65+## Les vignettes de référence
66+
67+Quand l'auteur fournit des vignettes de référence, ce sont **ses** choix d'inspiration : le
68+style visé (cadrage, palette, lumière, traitement graphique, place du texte). Regarde-les et
69+inscris tes compositions dans cette famille plutôt que d'inventer un style étranger. On
70+reprend le style, jamais les personnes, les visages, les logos ni le texte qu'elles montrent.
71+
72+## Proposer plusieurs compositions
73+
74+Les variantes servent à l'A/B test de YouTube : elles doivent être **vraiment différentes**
75+pour que le test apprenne quelque chose — pas trois fois la même scène avec un autre mot.
76+Varie le ressort de curiosité (émotion, objet, contraste avant/après, chiffre), l'élément
77+focal, la présence ou non de texte.
78+
79+Pour chaque composition, décris la scène comme on la décrirait à un photographe ou un
80+illustrateur, en phrases et non en mots-clés : qui, où dans le cadre, quelle expression, où
81+regarde-t-il, quel objet, quel fond, quelle lumière, quelles couleurs.
82+
83+## Relecture avant de proposer
84+
85+Pour chaque composition, vérifie une fois — et corrige ce qui ne passe pas :
86+
87+1. Comprise en une seconde, en petit ?
88+2. Donne-t-elle envie de savoir la suite ?
89+3. Deux points focaux au maximum ?
90+4. Le texte complète-t-il le titre sans le répéter, en 0 à 3 mots ?
91+5. Contraste fort, deux ou trois couleurs ?
92+6. Visage expressif, regard intentionnel ?
93+7. Rien d'important en bas à droite ni sur le bord bas ?
94+8. Fidèle aux vignettes de référence, s'il y en a ?
95+9. La vidéo tient-elle la promesse de l'image ? Pas de faux chiffre, pas de démo qui n'existe pas.
96+
97+Une seule passe suffit : la première relecture attrape l'essentiel.
new file mode 100644
@@ -0,0 +1,97 @@
1+---
2+name: youtube-thumbnail
3+description: Proposer des compositions de vignettes YouTube avant de les générer — scène, texte, couleurs, et la curiosité que chacune crée. À utiliser quand il faut imaginer ou critiquer une vignette, ou rédiger ce qu'un modèle d'image doit dessiner.
4+---
5+
6+# Composer une vignette YouTube
7+
8+Une vignette n'illustre pas la vidéo : elle crée une question que seul le clic résout. Le titre
9+et la vignette travaillent ensemble — l'un ne répète jamais l'autre.
10+
11+Ce skill sert à **proposer des compositions** avant toute génération d'image. Une composition,
12+c'est : ce que montre l'image (la scène), le texte éventuel, deux ou trois couleurs, et en une
13+phrase la question qu'elle pose au spectateur.
14+
15+## Les deux exigences qui priment
16+
17+1. **La curiosité.** La vignette ouvre une tension : un avant/après, un objet inattendu, une
18+ émotion forte face à quelque chose qu'on ne voit qu'à moitié, un chiffre qui choque. Sans
19+ tension, tout le reste est inutile.
20+2. **Le test du coup d'œil.** Comprise en une seconde, à la taille d'un téléphone (environ
21+ 280 × 157 px). Si l'œil doit chercher, c'est raté.
22+
23+Tout le reste sert ces deux exigences.
24+
25+## Règles de composition
26+
27+- **Un point focal, deux au maximum.** Au-delà de trois éléments distincts, l'image devient
28+ bruit. Un élément domine nettement.
29+- **Simple et aéré** : un tiers de l'image environ reste vide (fond uni, flou, dégradé).
30+- **Contraste fort** : sujet clair sur fond sombre ou l'inverse ; couleurs franches (rouge,
31+ jaune, orange, cyan) ; deux ou trois couleurs, pas plus.
32+- **Hiérarchie** : texte, puis visage, puis objet ou logo, puis fond.
33+- **Pensé pour le mobile** : rien de petit ni de fin ; pas de détail qui ne compte qu'en grand.
34+
35+## Le visage
36+
37+- Un visage expressif attire plus qu'une scène sans personne. L'expression n'est jamais
38+ neutre : surprise, incrédulité, inquiétude, amusement, colère contenue — une émotion mêlée
39+ vaut souvent mieux qu'une émotion simple.
40+- **Le regard dirige l'attention** : face caméra, il crée le lien ; tourné vers l'objet, il y
41+ emmène l'œil du spectateur.
42+- Visage grand (30 à 50 % du cadre), plutôt d'un côté, l'élément focal de l'autre.
43+- Une seule personne, deux au plus.
44+
45+## Le texte
46+
47+- **0 à 3 mots**, 5 au grand maximum. Pas de texte du tout est une option valable.
48+- **Il complète le titre, il ne le répète pas** : il ajoute un chiffre, une réaction, un
49+ verdict, l'enjeu (« 54 % GONE », « TROP TARD », « ÇA MARCHE ? »).
50+- Gros, gras, condensé, en capitales, avec un contour ou un aplat pour rester lisible.
51+- Placé en haut à gauche ou au centre ; jamais en bas à droite.
52+
53+## Zones à éviter
54+
55+- **Bas à droite** : la durée de la vidéo s'y affiche. Jamais rien d'important.
56+- **Bord bas** : la barre de progression.
57+- Marges d'environ 8 % sur les côtés et 10 % en haut et en bas.
58+
59+## Logos et objets réels
60+
61+Un logo d'outil ou de marque reconnaissable sert de badge (« ça parle de ça »). Mais un modèle
62+d'image ne sait pas dessiner un logo fidèlement : si la composition en a besoin, dis-le pour
63+que l'auteur fournisse l'image, plutôt que de compter sur le modèle.
64+
65+## Les vignettes de référence
66+
67+Quand l'auteur fournit des vignettes de référence, ce sont **ses** choix d'inspiration : le
68+style visé (cadrage, palette, lumière, traitement graphique, place du texte). Regarde-les et
69+inscris tes compositions dans cette famille plutôt que d'inventer un style étranger. On
70+reprend le style, jamais les personnes, les visages, les logos ni le texte qu'elles montrent.
71+
72+## Proposer plusieurs compositions
73+
74+Les variantes servent à l'A/B test de YouTube : elles doivent être **vraiment différentes**
75+pour que le test apprenne quelque chose — pas trois fois la même scène avec un autre mot.
76+Varie le ressort de curiosité (émotion, objet, contraste avant/après, chiffre), l'élément
77+focal, la présence ou non de texte.
78+
79+Pour chaque composition, décris la scène comme on la décrirait à un photographe ou un
80+illustrateur, en phrases et non en mots-clés : qui, où dans le cadre, quelle expression, où
81+regarde-t-il, quel objet, quel fond, quelle lumière, quelles couleurs.
82+
83+## Relecture avant de proposer
84+
85+Pour chaque composition, vérifie une fois — et corrige ce qui ne passe pas :
86+
87+1. Comprise en une seconde, en petit ?
88+2. Donne-t-elle envie de savoir la suite ?
89+3. Deux points focaux au maximum ?
90+4. Le texte complète-t-il le titre sans le répéter, en 0 à 3 mots ?
91+5. Contraste fort, deux ou trois couleurs ?
92+6. Visage expressif, regard intentionnel ?
93+7. Rien d'important en bas à droite ni sur le bord bas ?
94+8. Fidèle aux vignettes de référence, s'il y en a ?
95+9. La vidéo tient-elle la promesse de l'image ? Pas de faux chiffre, pas de démo qui n'existe pas.
96+
97+Une seule passe suffit : la première relecture attrape l'essentiel.
added skills/youtube-titles/SKILL.md +183 -0
new file mode 100644
@@ -0,0 +1,183 @@
1+---
2+name: youtube-titles
3+description: Generate 30 YouTube titles that earn clicks without lying — 20 built on three structural formulas (bold statement, how-to, time frame) with psychological levers, plus 10 free titles across proven click patterns (curiosity gap, outcome, contrarian, numbers, comparison, story, how-to). Every title is built from the concrete facts of the video and comes with a rationale. Use when the user wants YouTube titles, title ideas, or title variants to A/B test.
4+---
5+
6+# YouTube Title Generator
7+
8+Read the CLAUDE.md file in the working directory if it exists. Do this silently — do not narrate that you're reading it. Use the context to inform your output.
9+
10+If a voice skill is installed, apply it. If not, pick up the user's natural voice from CLAUDE.md context.
11+
12+You generate YouTube titles that earn clicks without resorting to lies. Every title is built on the **click equation: curiosity + relevance + credibility**. A title needs all three — curiosity alone is clickbait, relevance alone is boring, credibility alone is forgettable.
13+
14+You produce a wide range (30 titles), from safe to polarizing, so the author can see several kinds of promises before choosing.
15+
16+## What You Need
17+
18+Ask the user for:
19+- **Video topic or script** — what the video covers
20+- **Key result or insight** — the most interesting thing in the video
21+- **Target audience** — who should click (pull from CLAUDE.md if available, don't re-ask)
22+
23+If the user provides a script or brief, extract what you need from it. Don't ask for information that's already there.
24+
25+## Step 1: Collect the Raw Material
26+
27+Before writing anything, list what the video actually contains.
28+
29+**The promise**
30+
31+| Element | Question |
32+| --- | --- |
33+| Transformation | What changes for the viewer: skills, career, income, time, way of working? |
34+| Big idea | The one claim from the video people would repeat to a friend |
35+| Audience | Who gains, and what they want or fear |
36+| Contrast | Where a modest effort leads to an outsized result, or where the advice goes against the grain |
37+
38+**The facts**
39+
40+| Fact | Examples |
41+| --- | --- |
42+| Tool / technology | Claude Code, Cursor, n8n, a specific feature or version |
43+| Input | one prompt, a screenshot, an old codebase, zero lines of code |
44+| Output | a working app, a deployed API, a dashboard, an automation |
45+| Time / effort | 20 minutes, one evening, 2 hours a day for 6 months |
46+| Number | 5 mistakes, 3 workflows, 40 % faster, €200 a month saved |
47+| Verdict | worth it or not, winner of a comparison, what broke |
48+
49+Titles can only use facts from this list. No fact, no number: never invent a duration, an amount or a result the video doesn't show.
50+
51+## Step 2: 20 Structured Titles
52+
53+Rotate through three formulas, never the same one twice in a row.
54+
55+### A. Bold statement + (what's behind it)
56+A short, strong claim, then the explanation or method in parentheses.
57+- "The End of the Junior Developer (and What Replaces It)"
58+- "Your To-Do List Is the Problem (Do This Instead)"
59+
60+### B. How to + desirable outcome + (mechanism)
61+The result the viewer wants, then how, or the angle nobody mentions.
62+- "How to Learn Any Framework in a Weekend (The 3-Pass Method)"
63+- "How to Get Hired Without a Degree (What Recruiters Actually Check)"
64+
65+### C. Time frame or number + (what to focus on)
66+A concrete amount of time or effort, then where to put it.
67+- "2 Hours a Day for 6 Months (The Skills Worth Learning Now)"
68+- "From Screenshot to Working Page in 18 Minutes (Full Build)"
69+
70+Spread these levers across the 20 titles, each in several titles:
71+
72+| Lever | How | Wording |
73+| --- | --- | --- |
74+| Time frame | A concrete, believable duration | "in 6 months", "2 hours a day", "in 30 days" |
75+| Transformation | A visible change in the viewer | "change your career", "you won't work the same way" |
76+| Insider knowledge | What most people miss | "what nobody tells you", "most people ignore this" |
77+| Status | Getting ahead | "ahead of 99 % of developers", "irreplaceable" |
78+
79+And these contrasts, in several titles:
80+- **Small input, big output:** "2 hours a day" → "a new career", "one screenshot" → "a full app".
81+- **Unexpected pairing:** two ideas that don't usually go together ("your career as a video game").
82+- **Counterintuitive advice:** "stop learning new frameworks", "do less to ship more".
83+
84+## Step 3: 10 Free Titles
85+
86+Ten more that leave the formulas aside: the most clickable titles you can find for this video, noticeably different from the first twenty. Draw on these patterns, at least five of them:
87+
88+### 1. Curiosity Gap
89+Create an information gap the viewer needs to close. Say enough to intrigue, not enough to satisfy.
90+- "The [Thing] Nobody Talks About in [Field]"
91+- "I Tested [X] for [Time Period]. Here's What Happened."
92+
93+### 2. Result / Outcome
94+Lead with the result. Numbers and specifics beat vague claims.
95+- "How I [Achieved Result] in [Timeframe]"
96+- "[Specific Number] [Things] That [Changed/Built/Fixed] My [X]"
97+
98+### 3. Challenge / Contrarian
99+Take a position that pushes against conventional wisdom. The title itself is an argument.
100+- "[Popular Thing] Is Wasting Your Time. Do This Instead."
101+- "Stop [Common Advice]. Here's Why."
102+
103+### 4. Specificity / Numbers
104+Concrete numbers make titles feel real and actionable. Odd numbers outperform even ones.
105+- "[Number] [Things] I Wish I Knew Before [X]"
106+- "The [Number]-Step System for [Outcome]"
107+
108+### 5. Comparison
109+Position two things against each other. Creates instant context and stakes.
110+- "[Thing A] vs [Thing B]: Which Actually Works?"
111+- "I Switched from [X] to [Y]. The Difference Is Huge."
112+
113+### 6. Story-Driven
114+Personal narrative hooks. The viewer clicks to hear what happened.
115+- "I [Did Unexpected Thing] and [Surprising Result]"
116+- "What Happened When I [Bold Action]"
117+
118+### 7. How-To / Tutorial
119+Direct value promise. Works best when the outcome is specific.
120+- "How to [Achieve Specific Result] (Step by Step)"
121+- "The Complete Guide to [X] for [Audience]"
122+
123+For tech, tutorial and tool videos, the content type points to the strongest pattern:
124+
125+| The video is… | Lead with |
126+| --- | --- |
127+| A build / demo | I built {output} with {tool} from {input} |
128+| A fast transformation | From {input} to {output} in {time} |
129+| A tool review | I used {tool} for {time}: {verdict} |
130+| A comparison | {tool A} vs {tool B} for {use case} |
131+| Time or money saved | {task}: from {before} to {after} with {tool} |
132+
133+## Writing the Variables
134+
135+Always use the precise version:
136+
137+| Vague | Precise |
138+| --- | --- |
139+| an app | a complete booking app |
140+| quickly | in 20 minutes |
141+| a few prompts | 3 prompts |
142+| AI | Claude Code |
143+| saves money | €200 a month |
144+| better | 40 % faster |
145+
146+Exact numbers beat round ones ("18 minutes" beats "under 20 minutes"), and the name of the tool beats the name of the category.
147+
148+## Polish
149+
150+- **Front-load the searchable term.** When the video is about a tool or technology, its name sits in the first 40 characters.
151+- **Parentheses carry the method or the bonus:** "(Do This Instead)", "(template included)", "(full code)", "(step by step)".
152+- **Show the verdict's direction.** For reviews and comparisons, hint at the outcome: "the cheaper one won" beats "the winner surprised me".
153+
154+## Output Format
155+
156+Present each title with:
157+
158+```
159+**[Title]**
160+Pattern: [which formula or pattern]
161+Why it works: [one sentence — what makes this clickable for the target audience]
162+```
163+
164+## After the List
165+
166+Recommend your **top 3 picks** and explain why. Pick three titles that make three different promises (for example one statement, one how-to, one free title), so an A/B test tells the author which kind of promise their audience prefers. Consider:
167+- Which ones have the strongest curiosity gap?
168+- Which ones most clearly signal value to the target audience?
169+- Which ones would stand out in a feed full of similar content?
170+
171+If the user has existing videos (check CLAUDE.md or ask), factor in what title styles have worked for their channel.
172+
173+## Rules
174+
175+- **High conviction, never a lie.** Be bold, take sides, be polarizing when it fits — but every title is a promise the video actually keeps.
176+- **30 distinct titles.** No two titles that only differ by a word; no formula twice in a row.
177+- **The core idea stays.** Every title is about this video, not a more clickable neighbouring topic.
178+- Every title under 60 characters when possible (displays fully on mobile), 70 at most
179+- No ALL CAPS words — YouTube audiences read it as shouting
180+- No generic filler words ("Amazing," "Incredible," "Mind-Blowing") unless they genuinely fit
181+- No vague promises: "How I Improved My Workflow" loses to "My Deployments Went From 1 Hour to 5 Minutes"
182+- Don't use the creator's name in the title unless they're already well-known enough for it to drive clicks
183+- If the video topic is niche, lean into specificity over broad appeal — the right 10K viewers beat 100K wrong ones
new file mode 100644
@@ -0,0 +1,183 @@
1+---
2+name: youtube-titles
3+description: Generate 30 YouTube titles that earn clicks without lying — 20 built on three structural formulas (bold statement, how-to, time frame) with psychological levers, plus 10 free titles across proven click patterns (curiosity gap, outcome, contrarian, numbers, comparison, story, how-to). Every title is built from the concrete facts of the video and comes with a rationale. Use when the user wants YouTube titles, title ideas, or title variants to A/B test.
4+---
5+
6+# YouTube Title Generator
7+
8+Read the CLAUDE.md file in the working directory if it exists. Do this silently — do not narrate that you're reading it. Use the context to inform your output.
9+
10+If a voice skill is installed, apply it. If not, pick up the user's natural voice from CLAUDE.md context.
11+
12+You generate YouTube titles that earn clicks without resorting to lies. Every title is built on the **click equation: curiosity + relevance + credibility**. A title needs all three — curiosity alone is clickbait, relevance alone is boring, credibility alone is forgettable.
13+
14+You produce a wide range (30 titles), from safe to polarizing, so the author can see several kinds of promises before choosing.
15+
16+## What You Need
17+
18+Ask the user for:
19+- **Video topic or script** — what the video covers
20+- **Key result or insight** — the most interesting thing in the video
21+- **Target audience** — who should click (pull from CLAUDE.md if available, don't re-ask)
22+
23+If the user provides a script or brief, extract what you need from it. Don't ask for information that's already there.
24+
25+## Step 1: Collect the Raw Material
26+
27+Before writing anything, list what the video actually contains.
28+
29+**The promise**
30+
31+| Element | Question |
32+| --- | --- |
33+| Transformation | What changes for the viewer: skills, career, income, time, way of working? |
34+| Big idea | The one claim from the video people would repeat to a friend |
35+| Audience | Who gains, and what they want or fear |
36+| Contrast | Where a modest effort leads to an outsized result, or where the advice goes against the grain |
37+
38+**The facts**
39+
40+| Fact | Examples |
41+| --- | --- |
42+| Tool / technology | Claude Code, Cursor, n8n, a specific feature or version |
43+| Input | one prompt, a screenshot, an old codebase, zero lines of code |
44+| Output | a working app, a deployed API, a dashboard, an automation |
45+| Time / effort | 20 minutes, one evening, 2 hours a day for 6 months |
46+| Number | 5 mistakes, 3 workflows, 40 % faster, €200 a month saved |
47+| Verdict | worth it or not, winner of a comparison, what broke |
48+
49+Titles can only use facts from this list. No fact, no number: never invent a duration, an amount or a result the video doesn't show.
50+
51+## Step 2: 20 Structured Titles
52+
53+Rotate through three formulas, never the same one twice in a row.
54+
55+### A. Bold statement + (what's behind it)
56+A short, strong claim, then the explanation or method in parentheses.
57+- "The End of the Junior Developer (and What Replaces It)"
58+- "Your To-Do List Is the Problem (Do This Instead)"
59+
60+### B. How to + desirable outcome + (mechanism)
61+The result the viewer wants, then how, or the angle nobody mentions.
62+- "How to Learn Any Framework in a Weekend (The 3-Pass Method)"
63+- "How to Get Hired Without a Degree (What Recruiters Actually Check)"
64+
65+### C. Time frame or number + (what to focus on)
66+A concrete amount of time or effort, then where to put it.
67+- "2 Hours a Day for 6 Months (The Skills Worth Learning Now)"
68+- "From Screenshot to Working Page in 18 Minutes (Full Build)"
69+
70+Spread these levers across the 20 titles, each in several titles:
71+
72+| Lever | How | Wording |
73+| --- | --- | --- |
74+| Time frame | A concrete, believable duration | "in 6 months", "2 hours a day", "in 30 days" |
75+| Transformation | A visible change in the viewer | "change your career", "you won't work the same way" |
76+| Insider knowledge | What most people miss | "what nobody tells you", "most people ignore this" |
77+| Status | Getting ahead | "ahead of 99 % of developers", "irreplaceable" |
78+
79+And these contrasts, in several titles:
80+- **Small input, big output:** "2 hours a day" → "a new career", "one screenshot" → "a full app".
81+- **Unexpected pairing:** two ideas that don't usually go together ("your career as a video game").
82+- **Counterintuitive advice:** "stop learning new frameworks", "do less to ship more".
83+
84+## Step 3: 10 Free Titles
85+
86+Ten more that leave the formulas aside: the most clickable titles you can find for this video, noticeably different from the first twenty. Draw on these patterns, at least five of them:
87+
88+### 1. Curiosity Gap
89+Create an information gap the viewer needs to close. Say enough to intrigue, not enough to satisfy.
90+- "The [Thing] Nobody Talks About in [Field]"
91+- "I Tested [X] for [Time Period]. Here's What Happened."
92+
93+### 2. Result / Outcome
94+Lead with the result. Numbers and specifics beat vague claims.
95+- "How I [Achieved Result] in [Timeframe]"
96+- "[Specific Number] [Things] That [Changed/Built/Fixed] My [X]"
97+
98+### 3. Challenge / Contrarian
99+Take a position that pushes against conventional wisdom. The title itself is an argument.
100+- "[Popular Thing] Is Wasting Your Time. Do This Instead."
101+- "Stop [Common Advice]. Here's Why."
102+
103+### 4. Specificity / Numbers
104+Concrete numbers make titles feel real and actionable. Odd numbers outperform even ones.
105+- "[Number] [Things] I Wish I Knew Before [X]"
106+- "The [Number]-Step System for [Outcome]"
107+
108+### 5. Comparison
109+Position two things against each other. Creates instant context and stakes.
110+- "[Thing A] vs [Thing B]: Which Actually Works?"
111+- "I Switched from [X] to [Y]. The Difference Is Huge."
112+
113+### 6. Story-Driven
114+Personal narrative hooks. The viewer clicks to hear what happened.
115+- "I [Did Unexpected Thing] and [Surprising Result]"
116+- "What Happened When I [Bold Action]"
117+
118+### 7. How-To / Tutorial
119+Direct value promise. Works best when the outcome is specific.
120+- "How to [Achieve Specific Result] (Step by Step)"
121+- "The Complete Guide to [X] for [Audience]"
122+
123+For tech, tutorial and tool videos, the content type points to the strongest pattern:
124+
125+| The video is… | Lead with |
126+| --- | --- |
127+| A build / demo | I built {output} with {tool} from {input} |
128+| A fast transformation | From {input} to {output} in {time} |
129+| A tool review | I used {tool} for {time}: {verdict} |
130+| A comparison | {tool A} vs {tool B} for {use case} |
131+| Time or money saved | {task}: from {before} to {after} with {tool} |
132+
133+## Writing the Variables
134+
135+Always use the precise version:
136+
137+| Vague | Precise |
138+| --- | --- |
139+| an app | a complete booking app |
140+| quickly | in 20 minutes |
141+| a few prompts | 3 prompts |
142+| AI | Claude Code |
143+| saves money | €200 a month |
144+| better | 40 % faster |
145+
146+Exact numbers beat round ones ("18 minutes" beats "under 20 minutes"), and the name of the tool beats the name of the category.
147+
148+## Polish
149+
150+- **Front-load the searchable term.** When the video is about a tool or technology, its name sits in the first 40 characters.
151+- **Parentheses carry the method or the bonus:** "(Do This Instead)", "(template included)", "(full code)", "(step by step)".
152+- **Show the verdict's direction.** For reviews and comparisons, hint at the outcome: "the cheaper one won" beats "the winner surprised me".
153+
154+## Output Format
155+
156+Present each title with:
157+
158+```
159+**[Title]**
160+Pattern: [which formula or pattern]
161+Why it works: [one sentence — what makes this clickable for the target audience]
162+```
163+
164+## After the List
165+
166+Recommend your **top 3 picks** and explain why. Pick three titles that make three different promises (for example one statement, one how-to, one free title), so an A/B test tells the author which kind of promise their audience prefers. Consider:
167+- Which ones have the strongest curiosity gap?
168+- Which ones most clearly signal value to the target audience?
169+- Which ones would stand out in a feed full of similar content?
170+
171+If the user has existing videos (check CLAUDE.md or ask), factor in what title styles have worked for their channel.
172+
173+## Rules
174+
175+- **High conviction, never a lie.** Be bold, take sides, be polarizing when it fits — but every title is a promise the video actually keeps.
176+- **30 distinct titles.** No two titles that only differ by a word; no formula twice in a row.
177+- **The core idea stays.** Every title is about this video, not a more clickable neighbouring topic.
178+- Every title under 60 characters when possible (displays fully on mobile), 70 at most
179+- No ALL CAPS words — YouTube audiences read it as shouting
180+- No generic filler words ("Amazing," "Incredible," "Mind-Blowing") unless they genuinely fit
181+- No vague promises: "How I Improved My Workflow" loses to "My Deployments Went From 1 Hour to 5 Minutes"
182+- Don't use the creator's name in the title unless they're already well-known enough for it to drive clicks
183+- If the video topic is niche, lean into specificity over broad appeal — the right 10K viewers beat 100K wrong ones