DEV Community

Cover image for The first 15 seconds decide your video. Here's how to make Claude write them.
ur-grue
ur-grue

Posted on

The first 15 seconds decide your video. Here's how to make Claude write them.

Retention graphs don't lie. Most videos lose a third of their audience before the 30-second mark. Whatever you spent on the edit, the thumbnail, the script — none of it matters if the open doesn't hold. The hook is the highest-leverage fifteen seconds you'll write all week.

So why do most AI-written hooks sound like a corporate explainer? "In this video, we'll dive deep into the fascinating world of..." That's not a hook. That's a throat-clear. The viewer is already gone.

I build a free, MIT-licensed library of Claude skills for media producers, and the YouTube hook generator is one people come back to. Here's the difference between a hook and a throat-clear — and how the skill gets it right.

A hook does one of three jobs

It doesn't "introduce the topic." It creates a reason to stay:

  • The open loop — pose a question the viewer now needs answered. "I moved abroad to learn the language. Two years later I still couldn't order coffee. Here's why."
  • The contrarian claim — say the thing that contradicts what they assume. "Immersion is the most overrated advice in language learning."
  • The stakes — make the cost of clicking away concrete. "If you're doing this one thing in your first month, you're wasting the whole year."

What the skill does

You give it your topic, your audience, and your tone. It gives back three hook options — not one — each built on a different mechanism above, each with a one-line note on why it works. You pick the one that fits your voice, and you learn the pattern for next time instead of outsourcing it forever.

It also refuses the tells: no "dive deep," no "in this video," no manufactured "you won't believe." Those are the phrases that pattern-match to AI, and an audience that watches a lot of YouTube clocks them instantly.

Why three, with reasons

Because the best hook for a video isn't knowable in advance — it depends on your delivery and your channel. Giving you one "optimised" hook is a worse product than giving you three real options and the logic to choose. The skill treats you as the creative lead, not the prompt-typist.

The honest limit

A hook can't save a video the audience doesn't want. The skill makes a strong topic open strongly — it can't make a weak topic interesting. And it works best when you give it a real angle, not just "make a video about productivity." Garbage in, polite refusal out.

Every skill in the library is quality-tested against a rubric whose hard floor is "does this read like a human in the medium." The hook generator lives or dies by that bar.

github.com/ur-grue/autopunk-media-skills

Top comments (0)