sergebulaev/youtube-skills / .codex-marketplace/youtube-skills/skills/yt-hook-scripter
yt-hook-scripter
VerifiedScript the spoken opening that decides retention: the first 30 seconds of a long-form YouTube video or the first 3 seconds of a YouTube Short. Uses 2026 patterns (restate-and-raise, cold-open payoff tease, question-and-contract, and the 3-second frame-one Shorts hook with a designed loop) to confirm the title's promise, open a loop, and earn the next 30 seconds with no intro. Use to write or fix a video opening. Not for the title (use yt-title-optimizer) or description (use yt-description-writer).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.4 KB |
| references/retention-beats.md | markdown | 3.3 KB |
references/retention-beats.md
View on GitHub# Retention Beats
The beat-by-beat structure for an opening that holds. Long-form targets the first
30 seconds; Shorts target the first 3.
## Long-form: the first 30 seconds, beat by beat
| Time | Beat | What it does |
|---|---|---|
| 0:00 - 0:03 | **Cold line or clip** | the first thing heard is the promise or the peak moment. No greeting. |
| 0:03 - 0:10 | **Restate the promise** | say, in your own voice, the exact thing the title promised, so the viewer confirms they are in the right place. |
| 0:10 - 0:18 | **Raise the stakes** | name the obstacle, the surprise, or why this is harder/bigger than it looks. This opens the loop. |
| 0:18 - 0:28 | **Watch-contract** | "by the end you will {capability/answer}", plus a bonus if you have one. Tell them why to stay. |
| 0:28 - 0:30 | **Pivot into the body** | hard cut into the first real section. No throat-clearing. |
### Long-form rules
- The promise from the title is restated by 0:10 at the latest.
- A loop is open by 0:18 (a question, a tease, an unresolved stake).
- The viewer knows what they get and why to stay by 0:28.
- If you have proof (a result, a before, a clip of the payoff), show it in the
first 10 seconds. Proof beats a claim.
- Re-hook around the 30 to 60 second mark and again at any natural dip; the
retention graph rewards a curve that stays flat or rises.
## Shorts: the first 3 seconds
| Time | Beat | What it does |
|---|---|---|
| 0:00 - 0:01 | **Frame-one hook** | the single most arresting line or visual, with on-screen text. State payoff or tension immediately. |
| 0:01 - 0:03 | **Confirm the stakes** | one line that makes the viewer need the resolution. |
| middle | **Deliver fast** | no filler; every second earns the next swipe. |
| end | **Loop line** | the final line/visual flows back into the opening so the Short loops. |
### Shorts rules
- The payoff or tension is on screen by frame one, readable with the sound off.
- No greeting, no logo, no slow zoom. The first second is the entire funnel.
- Design the ending to imply the beginning. Loop-throughs are the strongest
Shorts signal.
- Keep it under 60 seconds where the content allows; a tight Short that loops
beats a long one that holds once.
## The re-hook (mid-video, long-form)
Retention does not only live in the first 30 seconds. Place a small re-hook at
each natural section break:
- A one-line tease of what is coming ("but the third one is the one that actually
moved the numbers").
- A pattern interrupt: a cut to B-roll, a change of location, an on-screen
callout.
- A payoff bump: deliver a small win mid-video so the curve rises.
## Common opening failures and the fix
| Failure | Why retention drops | Fix |
|---|---|---|
| Greeting first | the viewer came for the promise, not a hello | open on the promise; greet later or not at all |
| Long intro animation | dead air before any value | cut the sting; hook on the first frame |
| Promise never restated | viewer is unsure they clicked right | restate the title's promise by 0:10 |
| No loop opened | nothing pulls the viewer forward | add a tease or an unresolved stake by 0:18 |
| Over-promised open | the body cannot pay it off | soften the open to what the video honestly delivers |
| Short opens slow | swipe-away before the hook lands | payoff on frame one, on-screen text, loop the end |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |