Index of every page on this site: llms.txt
All skills
sergebulaev avatar

/yt-hook-scripter

@f422cea
Run it yourself

Script 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).

Use this Skill: https://skilld.dev/gh/sergebulaev/youtube-skills/yt-hook-scripter

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesretention-beats.md

≈836 tokens on demand. Your agent reads this file only when SKILL.md points to it.

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

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill scripts YouTube video openings by parsing external URLs and utilizing internal tools for publishing. While these features are core to its purpose, processing external content introduces a minor surface for indirect prompt injection, partially mitigated by a human approval step before publishing.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at f422cea. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago

README badge

README badge for sergebulaev/youtube-skills/yt-hook-scripter