Storytelling hooks
Seven Claude Code skills that apply six psychology-based storytelling levers across short-form video, YouTube, titles & thumbnails, carousels, email, and website wireframes. General-purpose for any niche.
npx -y skills add yaxeen/storytelling-skills --skill storytelling-hooksAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when writing any short-form video script, hook, opening line, or scroll-stopping content (TikTok, Reels, Shorts) for any niche or business — when the first 2 seconds must grab attention. Also the shared psychology core (six storytelling levers) that the other storytelling-suite skills reference.
SKILL.md
10.5 KB, as published. Nobody here has run it
Storytelling Hooks: The Six Psychology Levers
- Short-form content lives or dies in the first 2 seconds.
- A strong hook stacks 2–3 levers in one line; a full script runs them in order.
- A hook has two jobs: stop the scroll AND filter for the right viewer. A hook that grabs everyone attracts the wrong audience — they leave at second 3, retention tanks, and the algorithm buries the video. Qualifying words ("freelancers", "if you run ads") cost a little reach and buy retention plus the right follows.
- This is the core skill of the storytelling suite. Other skills (long-form-youtube, titles-and-thumbnails, carousel-narratives, email-hooks, wireframe-writer, wireframe-reviewer) recap these levers and link back here.
When to Use
- Writing a reel / Short / TikTok script or opening line.
- Any niche or business: education, SaaS, fitness, finance, faith, food, B2B, personal brand.
- The moment must stop the scroll before the brain decides to move on.
- When a draft feels flat and you need to diagnose which lever is missing.
The Six Levers (Quick Reference)
| # | Lever | One-line job |
|---|---|---|
| 1 | Curiosity gap | Open a loop, don't close it |
| 2 | Emotional mirror | Target the feeling, not the fact |
| 3 | Conflict engine | Goal + obstacle = tension |
| 4 | Relatability | Broadest shared feeling → "this is me" |
| 5 | Pattern + surprise | Set expectation, then break it |
| 6 | Three-act structure | Setup → problem → resolution |
1. Curiosity Gap
- What: Open a question, don't answer it. The brain hates an unfinished loop.
- Why: An incomplete pattern creates tension; attention holds at the gap until it closes.
- Move: Reference something specific but unnamed — "this mistake", "this one setting", "the one habit". End on a cliff: "...and that's when everything changed."
- Stronger: Add a stake (reward gained or problem removed) → two gaps: "what is it?" + "what happens?"
- Example: "Most people lose money on this app without ever noticing the one toggle that's draining it."
2. Emotional Mirror
- What: Target a feeling, not just a fact.
- Why: Naming a feeling the viewer already carries makes them re-feel it in the moment — the content becomes about them.
- Move: Swap dry information for the emotion underneath it.
- Example: Fact → "Here's a tip for staying productive." Mirror → "If your to-do list makes you feel behind before the day even starts, this is for you."
3. Conflict Engine
- What: A goal plus an obstacle. No obstacle = no tension.
- Why: The brain invests in unresolved tension: "will it work out or not?"
- Move: Name what's wanted, then what blocks it (a common mistake, a hidden trap, a force).
- False obstacles: The most gripping conflicts are often self-made — a fear or excuse the person creates. Applies to characters and to the viewer being addressed.
- Example: "You're doing everything right to grow — and one invisible habit is quietly capping your results."
4. Relatability
- What: Pick a feeling or situation your target audience shares. Universal within the audience you want — not universal to everyone.
- Why: People connect to what they see themselves in. But maximum breadth attracts viewers who won't stay or follow; relatability serves qualification, not raw reach.
- Move: Choose the broadest shared experience inside your niche, and keep a qualifying signal in the line.
- Trade-off: Vivid detail adds texture but can shrink reach. "Waking at 4am in astronaut training" relates to no one; "waking up tired" relates to everyone — but "waking up tired" attracts everyone and converts no one. "Waking up tired because a client's revisions kept you up" relates to exactly the freelancers you want.
- Example: "Ever sent a message, then refreshed your phone every 10 seconds waiting for the reply?"
5. Pattern + Surprise
- What: Set an expectation, then break it.
- Why: The brain predicts what's next; a prediction broken in an interesting way grabs attention and makes the moment stick.
- Move: "Everything looks fine... but...". The word "but" is the switch. Surprise needs a setup first.
- Example: "She followed every rule in the productivity book. But the one thing that finally worked wasn't in it."
6. Three-Act Structure
- What: The skeleton of every story.
- Setup — normal world, everything ordinary.
- Problem — tension, mistake, or danger enters.
- Resolution — the outcome, carrying a lesson or feeling.
- Why: Gives the brain a clear arc (stability → disruption → release) that feels complete.
- Example: ordinary launch day → sales flatline and panic → the single change that turned it around.
The Three Hook Layers (Short-Form Video)
A Reel/Short/TikTok hook is not one line — it's three elements landing at 0:00, and most feeds autoplay muted:
| Layer | What it is | Rule |
|---|---|---|
| Visual first frame | What's on screen at 0:00 | Must intrigue with sound off — motion, an odd object, a mid-action moment |
| Spoken line | The first sentence | Where the levers live (this skill) |
| Text overlay | On-screen text | Complements the spoken line, never duplicates it — the other half of the gap |
- Overlay + spoken line pair like a title + thumbnail: one names the gap, the other shows the stakes/emotion.
- Always deliver all three layers when writing a video hook, not just the spoken line.
Generation Workflow
When asked to write a hook or script:
- Intake. Confirm before writing: niche, exact audience (who should follow, not just who might watch), platform, goal (follows / saves / sales / views), and tone. If key facts are missing, ask up to 2 questions when the user can respond; otherwise state your assumptions explicitly at the top and proceed.
- Variants. Read patterns.md (same folder) first — fill-in structures per lever, first-frame concepts, overlay pairings — then write 5+ hook options, each stacking 2–3 levers, levers labeled. Adapt the patterns to the niche; never reuse a worked example verbatim, even when it matches the topic.
- Select. Score against the Pre-Publish Checklist; recommend one and say why (which gaps it opens, who it qualifies).
- Script. Expand the winner using the lever order below, specifying all three hook layers for the opening.
Bad → Good Rewrite
- ❌ "Here are 3 budgeting tips for freelancers." — a topic label: no gap, no feeling, no tension. Nothing is at stake and nothing is unresolved.
- ✅ "You landed a $3,000 client last month — so why is your bank account still empty?" — relatability + emotional mirror (the fear behind the balance) + curiosity gap (why?) + a concrete number, and "client" qualifies for freelancers.
- The delta: the fact was replaced by the feeling underneath the fact, and a closed statement became an open question with stakes.
Building a Full Hook or Script
- Most short scripts are 3–6 lines (~20–45 seconds spoken; ~2.5 words/second is a workable pace check). Run the levers in order:
- Open (1 + 4, often + 2): curiosity gap wrapped in a relatable feeling. The scroll-stopper. Must work in 2 seconds.
- Build tension (3): introduce the obstacle or common mistake; raise stakes.
- Twist if possible (5): break the expectation you set. Optional but powerful.
- Pay off (6 resolution): resolve with the lesson or emotional point.
- Close with a bookend (below).
- Worked example (stacked):
- "Ever feel like you're working harder than everyone but falling behind? (relatability + mirror)
- Most people blame their schedule — the real leak is one habit they repeat every morning. (conflict + curiosity gap)
- Fix that one thing and the whole day finally clicks." (resolution + mirror)
The Bookend Technique & CTA
- Repeat a key phrase or number from the hook in the final line.
- Start and end touching the same phrase = the brain registers "completion" → satisfying, and pushes the viewer to comment/share.
- One CTA, matched to the intake goal: follows → "I post [X] for [audience] every week"; saves → "save this for your next [moment]"; comments → ask one specific question. Fold the CTA into the bookend line rather than tacking it on after.
- Overlays aren't only for 0:00 — flash the key phrase of each beat (twist, payoff) as on-screen text to serve muted viewers throughout.
- Tip: Concrete numbers and time gaps ("3 times", "in 7 days", "for 5 years") sharpen a hook. Reach for a specific number whenever facts allow.
Common Mistakes
| Mistake | Fix |
|---|---|
| Hook answers its own question | Keep the gap open until the payoff line |
| Hook chases everyone ("stop scrolling!") | Add a qualifying word — the right viewer beats the most viewers |
| Only the spoken line written | Specify visual first frame + text overlay too |
| Overlay repeats the spoken line | Overlay carries the other half of the gap |
| Two ideas in one hook | One gap per hook; save the second for another post |
| Gap the video never pays off | Clickbait kills retention and trust — close every loop you open |
| Vague where a number exists | "3 steps", "$3,000", "in 7 days" beat "a few", "a lot", "quickly" |
Pre-Publish Checklist
- Does line 1 open a curiosity gap, working in under 2 seconds?
- Is a real feeling targeted, not a dry fact?
- Is there a goal + obstacle creating tension?
- Is the core feeling universal within the target audience — and does a qualifying signal filter for the right viewer?
- Are all three hook layers specified (first frame, spoken line, overlay)?
- Is there at least one moment that breaks expectation?
- Does it move through setup → problem → resolution?
- Does the final line bookend back to the opening?
- If a line is flat, ask which lever is missing and add it.
Related Skills (Storytelling Suite)
- long-form-youtube — the levers across 8–20 min videos.
- titles-and-thumbnails — the levers in the click.
- carousel-narratives — the levers slide-by-slide.
- email-hooks — the levers in subject lines and inboxes.
- wireframe-writer / wireframe-reviewer — the levers in web page structure.