agentleFS
claudiocebpazclaudiocebpaz/blotato-opencode/.claude/skills/viral-hooks/SKILL.md

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

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
  1. Distinctive:

    If the topic is missing, ask.

    line 35
  2. Distinctive:

    Read the first 3 words of each variation alone.

    line 63
  3. Distinctive:

    Stop doing [common action] right now.

    line 117
  4. Distinctive:

    Do not [common action] unless you know these [N] secrets.

    line 118
  5. Distinctive:

    Avoid these common errors when [task].

    line 120
  6. Distinctive:

    Don't buy [product] before watching this.

    line 121
  7. Distinctive:

    Don't make the same mistake I did with [thing].

    line 124
  8. Distinctive:

    Do you know the secret to [achieving something]?

    line 208
  9. Distinctive:

    Don't scroll if you want to [achieve something].

    line 249
  10. Distinctive:

    Don't scroll past this if you want [benefit].

    line 250
  11. Distinctive:

    Don't miss [opportunity].

    line 253
  12. Distinctive:

    Don't hate me, but [hard truth].

    line 264
  13. Distinctive:

    Could it stand alone as a tweet?: If the hook only makes sense with the body, it's too weak.

    line 277
  14. Distinctive:

    No generic AI openers: Never "In today's fast-paced world," "Let me tell you," "Are you ready to," or "Picture this."

    line 279
  15. Distinctive:

    One hook, one idea: Do not stack two hooks. Pick the strongest.

    line 280
  16. Very specific:

    Don't return a hook with placeholders left unfilled.

    line 284
  17. Distinctive:

    Don't dump the whole library on the user.

    line 285
  18. Distinctive:

    Don't pick a generic category (Listicle, Question) when the topic has a strong opinion or a real number — those map to higher-ceiling …

    line 286
  19. Distinctive:

    Don't reuse the same category for every post in a batch.

    line 287

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.md just 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:

  1. The topic — what the post is about.
  2. 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.md in 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.

AngleBest category
A result, number, or experiment you ranThe Receipt
A strong opinion or wedgeContrarian / Myth-Buster
A mistake people makeNegative Frame
A tactic you copied from someoneStolen Lessons
An unanswered question or open loopCuriosity Gap
A how-to with multiple pointsListicle / Number
Insider knowledgeSecret / Insider
Speaking to one specific groupAudience Callout
A question that makes them stopQuestion Hook
A change over time, a storyTransformation / Story
A fast, low-effort winSpeed / Effortless
A reason to act nowUrgency / Stop-Scroll
A raw, personal admissionConfession / 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.

  1. I tested [N] [things]. Only [smaller N] worked.
  2. I [did specific thing] for [time period]. Here's what happened.
  3. [Big accomplishment] — here are [N] lessons.
  4. I audited [N] [things]. Here are [N] tips to [outcome].
  5. I asked [N] experts about [topic]. Here's what they said.
  6. How I went from [past situation] to [result] in [time].
  7. Here's how I [achieved result] in [time frame].
  8. Here's proof that [claim everyone doubts].
  9. 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.

  1. Most people think [common belief]. Here's why they're wrong.
  2. [Common practice] is dead. Stop doing it for [outcome].
  3. Everything you know about [subject] is wrong.
  4. Here's why [common advice] doesn't work.
  5. [Topic] is overrated.
  6. Unpopular opinion: [contrarian take].
  7. Here's why I disagree with [common belief].
  8. Forget everything you've heard about [topic].
  9. 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.

  1. [N] mistakes you're making with [task].
  2. Stop doing [common action] right now.
  3. Do not [common action] unless you know these [N] secrets.
  4. Here's why you're failing at [task].
  5. Avoid these common errors when [task].
  6. Don't buy [product] before watching this.
  7. As a [niche], please stop making this mistake.
  8. Here's why you've been doing [task] wrong all along.
  9. 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.

  1. [Famous person] makes [money] a month. We're about to steal it.
  2. I copied [specific thing]. Here's what happened.
  3. [Famous brand] does [specific thing]. I tried it. Result: [outcome].
  4. Here's a [industry] hack [experts] don't want you to know.
  5. [Famous person] shut down their [business] to go all in on [venture].
  6. 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.

  1. [N] things that feel illegal to know.
  2. Here's what nobody tells you about [topic].
  3. I can't believe no one told me this.
  4. Here's the hidden truth about [situation].
  5. Here's what I wish I knew before I started.
  6. Here's a secret I learned the hard way.
  7. Here's what happened when I tried [action].
  8. I can't believe more people aren't talking about this.
  9. 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.

  1. [N] things about [niche] I wish I knew earlier.
  2. [N] [niche] tools that save you hundreds of hours.
  3. [N] surprising facts about [topic] that will [outcome].
  4. Here are [N] signs that you should [action].
  5. [N] ways to level up your [area].
  6. [N] steps to master [skill] that lead to [benefit].
  7. Here are [N] tips to [outcome].
  8. [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.

  1. [Industry] does not want you to know this secret.
  2. Here's the secret to [outcome].
  3. Here's a secret I haven't shared before.
  4. Exposing my secret to [result].
  5. Here's a secret [experts] don't want you to know.
  6. 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.

  1. [Specific group], stop scrolling.
  2. Attention [group], you need to see this.
  3. [Target audience] will never admit these secrets.
  4. Calling all [group]: [promise].
  5. 99% of [audience] don't understand this.
  6. 98% of [niche] gets this wrong. Maybe you do too.
  7. [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.

  1. Did you know [shocking statistic]?
  2. Are you still [common action]?
  3. Ever wonder why [pain point] keeps happening?
  4. Are you tired of [frustration]? Try this.
  5. Have you ever felt [specific emotion]?
  6. Do you know the secret to [achieving something]?
  7. Ever wondered how to [goal]? Let me show you.
  8. 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.

  1. Here's the before and after of [project].
  2. Brace yourself for the transformation in my [area].
  3. How I [achieved result] without [common requirement].
  4. Here's how I turned my failure into success.
  5. I challenged myself to [hard thing]. Here's what happened.
  6. I did [thing] for a week. Here's what happened.
  7. Here's a simple habit that transformed my [life / health / work].
  8. 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.

  1. Here's how to [goal] in just [short time].
  2. Here's how to [goal] without [common obstacle].
  3. Here's how to [goal] with zero experience.
  4. Here's how to [task] like a [pro].
  5. Here's a [time frame] hack for [task].
  6. Here's how to [goal] on a budget.
  7. Here's how to get [desired item] for free.
  8. Here's a shortcut to [goal].
  9. 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.

  1. Don't scroll if you want to [achieve something].
  2. Don't scroll past this if you want [benefit].
  3. Everyone needs to know this.
  4. Here's your sign to try [activity].
  5. Don't miss [opportunity].
  6. This changes everything about [topic].
  7. 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.

  1. I can't believe I'm about to say this, but [admission].
  2. Don't hate me, but [hard truth].
  3. Here's a tough pill that [audience] can't swallow.
  4. I have to confess something I've avoided saying.
  5. 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.