agentleFS
milad-ahmdmilad-ahmd/agent-skills/skills/hook-generator/SKILL.md

hook-generator

Skill5 starsChanged 15 days agoMITView on GitHub

Generates scroll-stopping hooks for short videos, posts, threads, emails, ads, and YouTube intros using proven psychological frameworks, then scores and ranks them for a specific audience and platform. Use when the user asks for hooks, opening lines, headlines, attention grabbers, or "how should I start this video or post".

9 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use reels-scripting, voice-builder and 1 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • mahiunfilteredSkill

    reels-scripting

    Turn a reference Instagram Reel into a script for your own Reel, tuned to your voice and repurposed from your newsletter content. Takes a Reel URL or Notion reference link, uses Apify to scrape the video, sends it to Gemini 2.5 Flash for full transcript + hook + structure analysis, then writes a new script applying the same patterns to your newsletter topic. Use this skill whenever the user says "script a reel", "reels scripting", "turn this into a reel", pastes an Instagram Reel URL, or references their Notion outlier reels database. Requires APIFY_API_TOKEN and GOOGLE_AI_API_KEY environment variables.

    Also in 3 projects that use this

  • mahiunfilteredSkill

    voice-builder

    Build a personalised voice profile inside a Cowork project from a short interview plus 3 to 5 sample pieces of writing. Works for any content format: LinkedIn posts, newsletters, essays, emails, blog posts, tweets, or any other published writing. Use this skill at the start of any Cowork project where the user wants Claude to learn who they are and how they write before drafting new content. Trigger whenever the user says "build my voice", "learn my voice", "set up my content system", "onboard me", "train on my writing", "train on my posts", "I want Claude to sound like me", or drops a batch of writing samples into chat at the start of a project. Also trigger for first-time Cowork users who need a voice foundation before writing anything. Always produces two files (about-me.md and voice.md) saved into the project root.

    Also in 3 projects that use this

  • FlavioZanoniSkill

    profile-optimizer

    Audit and optimize a LinkedIn profile for recruiter discoverability using browser automation. Fixes Open to Work settings, headline keywords, location, top skills, languages, projects, About section, and experience descriptions. Use when user wants to improve their LinkedIn profile for job searching or increase inbound recruiter messages. Part of the Mercury job search toolkit.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 2

    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:

    Never promise what the content doesn't deliver.

    line 35
  2. Very specific:

    Use real numbers from the user only.

    line 36
  3. Distinctive:

    Avoid clichés ("In today's fast-paced world", "Did you know…" without a payoff).

    line 38

“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

Hook Generator

The first line decides whether anyone reads or watches the rest.

Input

The topic or content, the platform (TikTok, Reels, Shorts, YouTube intro, X, LinkedIn, email subject, ad), the audience and their main pain or desire, and the tone (bold, friendly, professional, funny).

Frameworks (produce at least 2 hooks per framework, about 20 in total)

  1. Curiosity gap: "Nobody talks about the real reason X happens…"
  2. Contrarian: "Unpopular opinion: X is a waste of time"
  3. Negative / warning: "Stop doing X if you want Y"
  4. Specific result: "How I got [specific number] in [timeframe] with [unexpected method]"
  5. Callout: "If you're a [specific person] who [specific situation], this is for you"
  6. Story drop-in: "I almost quit last Tuesday."
  7. List or promise: "3 tools that save me 10 hours a week"
  8. Question: "Why do 90% of X fail at Y?", but only with a real stat or attribution.
  9. Before/after: "From X to Y. Here's what changed."
  10. Myth-bust: "You've been told X. That's wrong."

For video, pair each hook with a visual hook (the action or shot in the first second) and the on-screen text.

Score and rank

Score each hook from 1 to 5 on: clarity, curiosity, relevance to the audience, specificity, and whether the content can deliver on the promise. Return the top 5 with a short explanation of why each works, followed by the rest.

Rules

  • Never promise what the content doesn't deliver. Clickbait kills retention and trust.
  • Use real numbers from the user only. Otherwise use placeholders like [X].
  • Match the length to the platform: a video hook is spoken in 2 seconds or less, email subjects are 50 characters or fewer, and the first line of a LinkedIn post is 12 words or fewer.
  • Avoid clichés ("In today's fast-paced world", "Did you know…" without a payoff).

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.