A skill your agent uses to write the hook — the opening that earns attention — for any social content: a caption's first line, a video's first three seconds, a carousel cover slide, a thread opener…

MITAuto-check passedMedia & Creative

Install Hook Writer

skills CLI
$ npx skills add social-media-skills/skills --skill hook-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install social-media-skills/skills hook-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hook-writer .claude/skills/hook-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hook-writer
GitHub stars
134
Token cost
~1.7k tokens
SKILL.md length
915 words
Files
6 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses to write the hook — the opening that earns attention — for any social content: a caption's first line, a video's first three seconds, a carousel cover slide, a thread opener…

  • Works in 6 steps: Read the foundation first → Pin the format and its cutoff → Find the hook in the content → …
  • Write the hook — the opening that earns attention — for any social content: a captions first line
  • SKILL.md covers Step 0 — Read the foundation…, Step 1 — Pin the format and…, Step 2 — Find the hook in the… and Step 3 — Generate many, across…, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hook Writer is an agent skill from social-media-skills/skills. Use to write the hook — the opening that earns attention — for any social content: a caption's first line, a video's first three seconds, a carousel cover slide, a thread opener, a YouTube title, or an email subject. Run when the user says "write a hook," "hook for this," "opening line," "first three seconds," "cover slide," "make this scroll-stopping," or when good content keeps getting ignored. Reads brand-profile and voice first so hooks sound like the brand, not viral-bait templates. Hooks must be TRUE to the…

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `evals/evals.json`, `references/examples.md` and `references/formats.md`).

It sits in Media & Creative, covering Slides and decks, Social media posts and Video scripts and shorts. It works with YouTube. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Write the hook — the opening that earns attention — for any social content: a captions first line
  • A videos first three seconds
  • A carousel cover slide
  • A thread opener

Example prompts

  • “s first line, a video”
  • “write a hook,”
  • “hook for this,”
  • “/hook-writer”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Read the foundation first
  2. Pin the format and its cutoff
  3. Find the hook in the content
  4. Generate many, across different mechanisms
  5. Score and select
  6. Tune to format and voice; confirm the payoff

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30eeb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hook Writer loads about 1.7k tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 189 tokens; SKILL.md has 915 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~189
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 915 words, ~1,730 tokens.

Download SKILL.mdSave it as .claude/skills/hook-writer/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
hook-writer
description
Use to write the hook — the opening that earns attention — for any social content: a caption's first line, a video's first three seconds, a carousel cover slide, a thread opener, a YouTube title, or an email subject. Run when the user says "write a hook," "hook for this," "opening line," "first three seconds," "cover slide," "make this scroll-stopping," or when good content keeps getting ignored. Reads brand-profile and voice first so hooks sound like the brand, not viral-bait templates. Hooks must be TRUE to the content that follows — this skill extracts the hook from the post's strongest element and never overpromises. For full captions use caption-writer; for full video scripts use the video skills. This writes the opening itself.
metadata.version
1.0.0
license
MIT

Hook Writer

The hook is the highest-leverage line in any piece of content. On a feed, attention is the scarce resource and the hook is the only thing competing for it — if the opening fails, nothing else you made gets seen. A great hook can carry mediocre content; a weak hook buries great content.

Two ideas run through everything here:

  1. A hook works by opening a gap. Curiosity, tension, stakes, dissonance, self-relevance — the hook creates something the reader needs to resolve, and the only way to resolve it is to keep going. Hooks are about the mechanism, not the template. "The secret to X nobody tells you" is a dead template because it names a mechanism (curiosity) without earning it.
  2. A hook is a promise, and the content must pay it off. A hook that overpromises wins the tap and loses the trust — and platforms punish the bounce that follows. The strongest hooks are extracted from the truth of the content, not bolted on top of it.

Step 0 — Read the foundation first

Load brand-profile.md and voice.md. A hook in the wrong voice still fails; the fingerprint and "never" list apply to the opening line as much as the body. If neither exists, run brand-profile (and voice-builder if samples exist) first.

Step 1 — Pin the format and its cutoff

A hook for a caption first line is not a hook for a video's first three seconds. Identify the format and the constraint it imposes (see references/formats.md):

  • Caption — one line before the "…more" cutoff (~125 chars on Instagram).
  • Video — the first 1–3 seconds, across three channels at once: what's on screen, the first spoken words, and on-screen text. Must work muted.
  • Carousel cover — slide 1 is the hook; it must promise the swipe.
  • Thread opener — the first post must promise the thread's payoff.
  • YouTube — title + thumbnail together.
  • Email — subject + preview text, mobile-truncated.

Step 2 — Find the hook in the content

Don't invent a hook and hope the content matches. Mine the actual material for its strongest raw element:

  • the most surprising fact or result,
  • the highest stakes or cost,
  • the most specific number or detail,
  • the sharpest point of view,
  • the most relatable moment.

That element is the hook's raw material. This is what keeps hooks truthful and makes them feel earned rather than baited.

Step 3 — Generate many, across different mechanisms

Write 5–10 candidate hooks, deliberately using different mechanisms from references/mechanisms.md (curiosity gap, contrarian, stakes, specificity, identity, story, mistake, transformation, question, timeliness, authority). Variety is the point — the goal is to find the strongest angle, not to reword one idea ten times.

Step 4 — Score and select

Run the candidates through the rubric in references/scoring.md and keep the best 1–2. The rubric checks: does it open a real gap? is it specific? is it true to the content? does it fit the format's cutoff? does it sound like them? would a stranger need the next beat? Discard the rest without sentiment — most hooks you write should die.

Step 5 — Tune to format and voice; confirm the payoff

Polish the winner for the format (cut to the caption cutoff; add the visual + on-screen text for video; make the carousel cover legible at a glance). Re-check it sounds like the brand. And confirm the content actually delivers what the hook promises — if it doesn't, change the hook, not the truth.

Show full SKILL.md (355 more words)Show less

Deliver options, recommend one

Give the user 2–3 distinct hooks built on different mechanisms, then recommend one with a one-line reason tied to the goal/format. Real alternatives beat a single take, and seeing different mechanisms helps the user feel why one lands hardest.

Quality bar — self-check

  • Does the hook open a gap a stranger needs to close?
  • Is it specific (a real number, detail, or claim), not vague?
  • Is it true — does the content pay it off without a bait-and-switch?
  • Does it land inside the format's cutoff (chars, or the first 3 seconds)?
  • Does it sound like them (fingerprint hit, "never" list respected)?
  • Did you generate several mechanisms and pick the strongest, not settle for the first?

If it doesn't pass "would a stranger need the next beat?", it isn't a hook yet.

Edge cases

  • Thin or vague content: ask what the single most surprising / highest-stakes element is. Don't fabricate a hook the content can't support.
  • Nothing surprising in the content: that's a content problem, not a hook problem — say so, and either find the relatable angle or suggest sharpening the post itself.
  • Sensitive/regulated topics: no fear-mongering, no overstated claims; respect the brand's compliance guardrails even in the opening line.
  • Video, muted-first: the on-screen text and the visual must hook on their own; assume sound off.
  • Tempted to overpromise for reach: don't. A truthful, slightly less sensational hook that the content delivers beats a viral-bait line that burns trust and bounces.
  • brand-profile, voice-builder — read first; supply voice and guardrails.
  • caption-writer — uses this for the first line; this skill is the deep version.
  • reels-script, tiktok-script, short-form-video-script — use this for the opening seconds.
  • thread-writer — uses this for the thread opener.
  • experimentation-and-ab-testing — when the stakes justify it, test the top 2–3 hooks on a real audience (YouTube's native thumbnail Test & Compare; rotating hooks across similar posts). The rubric picks your best guess; audience data outranks the rubric.

References

  • references/mechanisms.md — the hook mechanism taxonomy (why each one works).
  • references/formats.md — hook craft by format and the cutoffs that govern each.
  • references/scoring.md — the scoring rubric, the generate-and-select method, anti-patterns.
  • references/examples.md — content → many hooks → scored → chosen, worked end to end.

© social-media-skills, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/hook-writer of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/examples.md
  • references/formats.md
  • references/mechanisms.md
  • references/scoring.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Hook Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hook Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hook Writer this skillsocial-media-skills/skills134—~1.7kAutomated safety check: PassMIT
Content RepurposerOneWave-AI/claude-skills3361 repos~395Automated safety check: PassMIT
Hook Writer Smsblacktwist/social-media-skills560—~3.7kAutomated safety check: PassMIT
AI Social Media ContentNeverSight/learn-skills.dev2171 repos~1.8kAutomated safety check: PassNone
Outlier Post FinderScrapeCreators/social-media-research-skills3.4k—~1.5kAutomated safety check: NotesMIT
Channel Formatsjeremylongshore/tons-of-skills-marketplace2.8k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Content Repurposer

    OneWave-AI/claude-skills

    Master skill that transforms ANY content into 8+ formats: slides, infographic, video script, podcast, social posts, email series, flashcards, quiz, one-pager, interactive game.

    336 GitHub starsUsed in 1 repo~395 tokens
    Media & CreativeAuto-check passed
  • Hook Writer Sms

    blacktwist/social-media-skills

    When the user wants help writing opening lines, hooks, first sentences, video hooks, thumbnails titles, or pin titles that grab attention.

    560 GitHub stars~3.7k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • AI Social Media Content

    NeverSight/learn-skills.dev

    Create AI-powered social media content for TikTok, Instagram, YouTube, Twitter/X.

    217 GitHub starsUsed in 1 repo~1.8k tokens
    Writing & ContentAuto-check passed
  • Outlier Post Finder

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline.

    3.4k GitHub stars~1.5k tokensUpdated 1 mo ago
    Writing & ContentAuto-check: notes
  • Channel Formats

    jeremylongshore/tons-of-skills-marketplace

    Transforms one piece of content into each marketing channel's native format — length, structure, hooks, and conventions — across LinkedIn, X threads, newsletters, Instagram, YouTube, short video…

    2.8k GitHub stars~1.3k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Create Viral Content

    aAAaqwq/AGI-Super-Team

    This skill synthesizes findings from 40 documented research sources AUTOMATIC ACTIVATION: Use this skill whenever generating content for social media platforms including Reddit posts, Twitter/X…

    105 GitHub starsUsed in 1 repo~3.6k tokens
    Writing & ContentAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Works with

Questions about Hook Writer

What does Hook Writer do?

A skill your agent uses to write the hook — the opening that earns attention — for any social content: a caption's first line, a video's first three seconds, a carousel cover slide, a thread opener…. Hook Writer is an agent skill from social-media-skills/skills. Use to write the hook — the opening that earns attention — for any social content: a caption's first line, a video's first three seconds, a carousel cover slide, a thread opener, a YouTube title, or an email subject.

When should I use Hook Writer?

Hook Writer fits situations like: write the hook — the opening that earns attention — for any social content: a captions first line; A videos first three seconds; A carousel cover slide; A thread opener.

How do I install Hook Writer in Claude Code?

Run `npx skills add social-media-skills/skills --skill hook-writer -a claude-code`. Or copy the skill folder (skills/hook-writer in social-media-skills/skills) into .claude/skills/hook-writer in your project. Claude Code loads it when a task matches its description.

How do I install Hook Writer in Codex?

Run `npx skills add social-media-skills/skills --skill hook-writer -a codex`. Or copy the skill folder (skills/hook-writer in social-media-skills/skills) into .agents/skills/hook-writer in your project. Codex loads it when a task matches its description.

Can I use Hook Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add social-media-skills/skills --skill hook-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hook-writer, .gemini/skills/hook-writer, .github/skills/hook-writer and .opencode/skills/hook-writer in your project.

What does Hook Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Hook Writer is instructions for the agent only.

Does Hook Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hook Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hook Writer use?

Hook Writer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hook Writer use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Hook Writer?

Skills that share tags, products or a category with Hook Writer: Content Repurposer (OneWave-AI/claude-skills, 336 stars), Hook Writer Sms (blacktwist/social-media-skills, 560 stars), AI Social Media Content (NeverSight/learn-skills.dev, 217 stars) and Outlier Post Finder (ScrapeCreators/social-media-research-skills, 3.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hook Writer?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

Source: social-media-skills/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.