viral-hooks
Skill2 starsChanged 4 months agoMITView on GitHub
A curated library of 100 proven viral hook frameworks across 13 categories (Receipts, Contrarian, Negative Frame, Stolen Lessons, Curiosity Gap, and more). Picks the strongest hook pattern for a given topic and platform, fills it in, generates 3 variations, and runs the first-3-words test. Triggers on "give me a hook for X," "write hook options," "my intro is boring," or any request for an opening line. Auto-invoked by post-writer and repurpose to open every draft with a tested hook instead of a generic AI intro.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- fliqrlabs/instagram-creator-skillstheir own version, first seen Nov 1, 2026
- buildwithreef/claude-skillstheir own version, first seen Jul 2, 2026
- vyralcontent/content-skillstheir own version, first seen Jun 22, 2026
- artemnovitckii/content-skillstheir own version, first seen Jun 20, 2026
- rediumvex/viral-hooks-skilltheir own version, first seen May 5, 2026
- prospapledge88/claude-skillstheir own version, first seen Apr 14, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- vyralcontent/content-skills★ 115same name
- rediumvex/viral-hooks-skill★ 93same name
- artemnovitckii/content-skills★ 91same name
- fliqrlabs/instagram-creator-skills★ 5same name
- buildwithreef/claude-skills★ 0same name
- prospapledge88/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- brand-briefSkill
- content-coachSkill
- post-graderSkill
- post-schedulerSkill
- post-writerSkill
- repurposeSkill
- social-managerSkill
- visual-producerSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
19 rules. 0 are common, 18 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 6 edited versions we read keep these.
18
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
If the topic is missing, ask.
- Distinctive: line 63
Read the first 3 words of each variation alone.
- Distinctive: line 117
Stop doing [common action] right now.
- Distinctive: line 118
Do not [common action] unless you know these [N] secrets.
- Distinctive: line 120
Avoid these common errors when [task].
- Distinctive: line 121
Don't buy [product] before watching this.
- Distinctive: line 124
Don't make the same mistake I did with [thing].
- Distinctive: line 208
Do you know the secret to [achieving something]?
- Distinctive: line 249
Don't scroll if you want to [achieve something].
- Distinctive: line 250
Don't scroll past this if you want [benefit].
- Distinctive: line 253
Don't miss [opportunity].
- Distinctive: line 264
Don't hate me, but [hard truth].
- Distinctive: line 277
Could it stand alone as a tweet?: If the hook only makes sense with the body, it's too weak.
- Distinctive: line 279
No generic AI openers: Never "In today's fast-paced world," "Let me tell you," "Are you ready to," or "Picture this."
- Distinctive: line 280
One hook, one idea: Do not stack two hooks. Pick the strongest.
- Very specific: line 284
Don't return a hook with placeholders left unfilled.
- Distinctive: line 285
Don't dump the whole library on the user.
- Distinctive: line 286
Don't pick a generic category (Listicle, Question) when the topic has a strong opinion or a real number — those map to higher-ceiling …
- Distinctive: line 287
Don't reuse the same category for every post in a batch.
“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Viral Hooks
Adaptation for THIS project. When you look for the wedge for the polarizing categories, read it from your brand brief in
brand-brief.md. This skill is the source of truth for hooks in the repo;_base/hooks.mdjust points here.
The hook is the first 5 seconds of any post or video. It decides whether the reader stops or scrolls. If you can hold 50% retention through the first 6 seconds of a short-form video, it has a real shot at going viral. The hook carries that weight, so it gets written first and rewritten until it earns the read.
You hold a library of 100 proven hook frameworks. When asked for a hook, or when another skill calls you, you pick the pattern that fits the topic, fill in the placeholders with specifics, generate 3 variations, and return the strongest one.
When to Activate
- "Give me a hook for [topic]"
- "Write hook options for my [platform] post"
- "My opening line is weak — fix it"
- "What should the first line of this video be?"
- Any time post-writer or repurpose needs to open a post, thread, or video script.
Workflow
Step 1: Get the topic and the angle
You need two things before picking a hook:
- The topic — what the post is about.
- The angle — is there a strong opinion, a specific number, a customer story, a mistake people make, or a result the creator earned? This decides the category. If you have a
brand-brief.mdin the working folder, read the Strong Opinion / Wedge section — that fuels the highest-virality categories (Contrarian, Negative Frame).
If the topic is missing, ask. Do not invent a topic.
Step 2: Pick a category
Match the angle to a category. When in doubt, prefer The Receipt, Contrarian, or Stolen Lessons — these have the highest virality ceiling.
| Angle | Best category |
| A result, number, or experiment you ran | The Receipt |
| A strong opinion or wedge | Contrarian / Myth-Buster |
| A mistake people make | Negative Frame |
| A tactic you copied from someone | Stolen Lessons |
| An unanswered question or open loop | Curiosity Gap |
| A how-to with multiple points | Listicle / Number |
| Insider knowledge | Secret / Insider |
| Speaking to one specific group | Audience Callout |
| A question that makes them stop | Question Hook |
| A change over time, a story | Transformation / Story |
| A fast, low-effort win | Speed / Effortless |
| A reason to act now | Urgency / Stop-Scroll |
| A raw, personal admission | Confession / Vulnerable |
Step 3: Fill in 3 variations
Pick 3 templates (from one category or across two), and fill the placeholders with real specifics from the topic. Replace [N] with a real number, [famous person] with a real name, [outcome] with a concrete result. Generic fills kill the hook.
Step 4: Run the first-3-words test
Read the first 3 words of each variation alone. Do they create curiosity, surprise, or emotional pull?
- "Here's what I" → fail (no pull)
- "I tested 47" → pass (number + open loop)
- "Most people think" → pass (sets up a fight)
- "98% of marketers" → pass (statistic + callout)
Cut filler from the front. The strongest word goes first.
Step 5: Return the best one
Return the strongest variation, name the category, and offer the other 2 as alternates. If you were called by another skill, hand back all 3 so it can choose.
The 100 Hook Library
Templates use [brackets] for the parts you fill in. The categories are ordered by virality ceiling, highest first.
1. The Receipt (proof, numbers, results) — highest ceiling
Earned credibility plus a specific number plus an open loop. The reader wants to know what happened.
- I tested [N] [things]. Only [smaller N] worked.
- I [did specific thing] for [time period]. Here's what happened.
- [Big accomplishment] — here are [N] lessons.
- I audited [N] [things]. Here are [N] tips to [outcome].
- I asked [N] experts about [topic]. Here's what they said.
- How I went from [past situation] to [result] in [time].
- Here's how I [achieved result] in [time frame].
- Here's proof that [claim everyone doubts].
- I built [result] in [time]. Here's how I reach the next goal.
Example: "I tested 47 candle scents. Only 3 sold."
2. Contrarian / Myth-Buster — highest ceiling, polarizing
Forces the reader to pick a side. Polarity drives comments, and comments drive reach. Pull the wedge from brand-brief.md.
- Most people think [common belief]. Here's why they're wrong.
- [Common practice] is dead. Stop doing it for [outcome].
- Everything you know about [subject] is wrong.
- Here's why [common advice] doesn't work.
- [Topic] is overrated.
- Unpopular opinion: [contrarian take].
- Here's why I disagree with [common belief].
- Forget everything you've heard about [topic].
- Here's why [popular product] isn't worth the hype.
Example: "Most candle makers think scent is the product. The product is calm."
3. Negative Frame / Mistake Callout
Loss aversion. People click faster to avoid a mistake than to gain a win.
- [N] mistakes you're making with [task].
- Stop doing [common action] right now.
- Do not [common action] unless you know these [N] secrets.
- Here's why you're failing at [task].
- Avoid these common errors when [task].
- Don't buy [product] before watching this.
- As a [niche], please stop making this mistake.
- Here's why you've been doing [task] wrong all along.
- Don't make the same mistake I did with [thing].
Example: "Stop putting candles in the bedroom. Here's where they actually work."
4. Stolen Lessons / Steal This
Borrowed credibility plus a tactic the reader can copy. Tested-by-someone proof.
- [Famous person] makes [money] a month. We're about to steal it.
- I copied [specific thing]. Here's what happened.
- [Famous brand] does [specific thing]. I tried it. Result: [outcome].
- Here's a [industry] hack [experts] don't want you to know.
- [Famous person] shut down their [business] to go all in on [venture].
- Here's what [celebrity/influencer] doesn't tell you about [topic].
Example: "I copied Apple's product page format. Sales went up 23%."
5. Curiosity Gap / Open Loop
Open a question in the first line and withhold the answer. The reader stays to close the loop.
- [N] things that feel illegal to know.
- Here's what nobody tells you about [topic].
- I can't believe no one told me this.
- Here's the hidden truth about [situation].
- Here's what I wish I knew before I started.
- Here's a secret I learned the hard way.
- Here's what happened when I tried [action].
- I can't believe more people aren't talking about this.
- Here's a trick nobody tells you about [topic].
Example: "Here's what nobody tells you about handmade businesses."
6. Listicle / Number Hook
A specific count promises a clear, skimmable payoff. Odd numbers and small numbers test best.
- [N] things about [niche] I wish I knew earlier.
- [N] [niche] tools that save you hundreds of hours.
- [N] surprising facts about [topic] that will [outcome].
- Here are [N] signs that you should [action].
- [N] ways to level up your [area].
- [N] steps to master [skill] that lead to [benefit].
- Here are [N] tips to [outcome].
- [N] things you need to stop doing right now.
Example: "5 things I wish I knew before I opened my shop."
7. Secret / Insider
Promises access to gated knowledge. Works when you have real insider standing.
- [Industry] does not want you to know this secret.
- Here's the secret to [outcome].
- Here's a secret I haven't shared before.
- Exposing my secret to [result].
- Here's a secret [experts] don't want you to know.
- The secret to [topic] is [secret most people skip].
Example: "Here's the secret to candles that fill a whole room."
8. Audience Callout / Pattern Interrupt
Names the exact reader. The right person feels spoken to and stops.
- [Specific group], stop scrolling.
- Attention [group], you need to see this.
- [Target audience] will never admit these secrets.
- Calling all [group]: [promise].
- 99% of [audience] don't understand this.
- 98% of [niche] gets this wrong. Maybe you do too.
- [Specific group], don't [action]. Here's why.
Example: "Small candle makers, stop scrolling."
9. Question Hook
A question the reader answers in their head. Mental commitment keeps them watching.
- Did you know [shocking statistic]?
- Are you still [common action]?
- Ever wonder why [pain point] keeps happening?
- Are you tired of [frustration]? Try this.
- Have you ever felt [specific emotion]?
- Do you know the secret to [achieving something]?
- Ever wondered how to [goal]? Let me show you.
- Are you making this mistake with [task]?
Example: "Are you still buying candles that die in a week?"
10. Transformation / Before-After / Story
A change over time. The gap between before and after is the hook.
- Here's the before and after of [project].
- Brace yourself for the transformation in my [area].
- How I [achieved result] without [common requirement].
- Here's how I turned my failure into success.
- I challenged myself to [hard thing]. Here's what happened.
- I did [thing] for a week. Here's what happened.
- Here's a simple habit that transformed my [life / health / work].
- A day in the life of a [profession] making [money] a month.
Example: "How I sold out 200 candles without spending a dollar on ads."
11. Speed / Effortless How-To
Low effort plus fast result. Removes the reason to scroll past.
- Here's how to [goal] in just [short time].
- Here's how to [goal] without [common obstacle].
- Here's how to [goal] with zero experience.
- Here's how to [task] like a [pro].
- Here's a [time frame] hack for [task].
- Here's how to [goal] on a budget.
- Here's how to get [desired item] for free.
- Here's a shortcut to [goal].
- Here's how to [achieve result] faster than ever.
Example: "Here's how to scent-test a candle in 60 seconds."
12. Urgency / FOMO / Stop-Scroll
A reason to act now. Use sparingly — overuse trains the audience to ignore it.
- Don't scroll if you want to [achieve something].
- Don't scroll past this if you want [benefit].
- Everyone needs to know this.
- Here's your sign to try [activity].
- Don't miss [opportunity].
- This changes everything about [topic].
- Save this for [the moment you'll need it].
Example: "Don't scroll if you want your candles to actually sell."
13. Confession / Vulnerable
Drop the persona. A real admission earns trust and 3-10x normal engagement.
- I can't believe I'm about to say this, but [admission].
- Don't hate me, but [hard truth].
- Here's a tough pill that [audience] can't swallow.
- I have to confess something I've avoided saying.
- I used to [do thing wrong]. Now I swear by [the fix].
Example: "I almost shut down my shop in March. Here's what saved it."
Hook-Writing Rules
Apply these to every hook before returning it:
- Specific beats abstract. "I tested 47 scents" beats "I tested many scents." Always fill placeholders with real numbers, names, and moments.
- First word is the strongest word. Lead with the number, the name, or the surprise. Cut "so," "okay," "today I want to talk about."
- Could it stand alone as a tweet? If the hook only makes sense with the body, it's too weak.
- No filler. Cut "really," "very," "just," "actually," "basically."
- No generic AI openers. Never "In today's fast-paced world," "Let me tell you," "Are you ready to," or "Picture this."
- One hook, one idea. Do not stack two hooks. Pick the strongest.
What NOT to Do
- Don't return a hook with placeholders left unfilled. Fill every
[bracket]with a real specific. - Don't dump the whole library on the user. Return 1 strong hook plus 2 alternates.
- Don't pick a generic category (Listicle, Question) when the topic has a strong opinion or a real number — those map to higher-ceiling categories (Contrarian, Receipt).
- Don't reuse the same category for every post in a batch. Vary the patterns so a feed of posts doesn't read as formulaic.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

