Install
$ agentstack add skill-yaxeen-storytelling-skills-storytelling-hooks ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ● Filesystem access Used
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
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.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: yaxeen
- Source: yaxeen/storytelling-skills
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.