hook-mining
/hook-mining
Mine a CSV of REAL top-performing hooks and generate alternatives that keep what made them work: hold the storytelling psychology and structure fixed, hot-swap only the power words. Use when the user has hook performance data (a Sandcastles / social-analytics export, scraped competitor hooks, their own analytics) and says "mine hooks", "remix hooks", "hook variations", "make hooks from this CSV", or "give me hook options from what's working". NOT for inventing hooks from nothing — that's viral-hook-writer.
- Author
- Ootto-AI ↗
- Repository
- claude-content-skills ↗
- Licence
- MIT
- Last repository change
- 07.11.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: mine_hooks.py
What it does and when to use it
Mine a CSV of REAL top-performing hooks and generate alternatives that keep what made them work: hold the storytelling psychology and structure fixed, hot-swap only the power words. Use when the user has hook performance data (a Sandcastles / social-analytics export, scraped competitor hooks, their own analytics) and says "mine hooks", "remix hooks", "hook variations", "make hooks from this CSV", or "give me hook options from what's working". NOT for inventing hooks from nothing — that's viral-hook-writer.
Triggers from the description
Arguments
/hook-mining [path to your hooks CSV]
Original author description
Mine a CSV of REAL top-performing hooks and generate alternatives that keep what made them work: hold the storytelling psychology and structure fixed, hot-swap only the power words. Use when the user has hook performance data (a Sandcastles / social-analytics export, scraped competitor hooks, their own analytics) and says "mine hooks", "remix hooks", "hook variations", "make hooks from this CSV", or "give me hook options from what's working". NOT for inventing hooks from nothing — that's viral-hook-writer.
How it works
- 1. Get real hooks in
- 2. Mine it
- 3. Remix — the part that matters
- Hard rules
- Failure modes
- Where it sits
SKILL.md preview
--- name: hook-mining description: > Mine a CSV of REAL top-performing hooks and generate alternatives that keep what made them work: hold the storytelling psychology and structure fixed, hot-swap only the power words. Use when the user has hook performance data (a Sandcastles / social-analytics export, scraped competitor hooks, their own analytics) and says "mine hooks", "remix hooks", "hook variations", "make hooks from this CSV", or "give me hook options from what's working". NOT for inventing hooks from nothing — that's viral-hook-writer. user-invokable: true argument-hint: "[path to your hooks CSV]" license: MIT metadata: author: Ootto version: "1.0.0" --- # Hook mining Most AI hook writing is slop for one of two reasons: it copy-pastes a hook that worked for someone else, or it "rewrites" it until the English is flat and the psychology is gone. This does neither. It keeps the **data for what worked** — the structure, the psychological mechanism, the rhythm — and swaps only the **power words**. Proven skeleton stays, skin changes. ## 1. Get real hooks in You cannot mine what you do not have. The input is a CSV of hooks that **actually performed**: - a **Sandcastles** (sandcastles.ai) export — it analyses the top videos in your niche and ranks the best hooks; export that tab to CSV - any social-analytics export with a hook/title/caption column and a views/likes/score column - competitor hooks pulled with the **agent-reach** skill, or breakdowns from **reel-analyzer** Column names are never predictable, so don't hand-parse. ## 2. Mine it ```bash python skills/hook-mining/mine_hooks.py hooks.csv [--top 40] ``` Auto-detects the hook column and the performance column, ranks, buckets by pattern, and flags the power words already present. Writes `hooks.mined.json`. Run `--selftest` to verify the parsing. Patterns it sorts into: `result-proof` · `time-bound` · `contrarian` · `secret-gap` · `listicle` · `how-to` · `warning-fear` · `newsjack` · `comparison` · `question` · `curiosity-tease` · `plain-statement`. ## 3. Remix — the part that matters For each hook worth reusing, produce 3–5 alternatives under one rule: > **Keep the psychology. Swap the power words.** Hold **fixed**: the pattern, the clause order, the specificity (a number stays a number), the rhythm and syllable shape, the tension and where it resolves, the point of view. Swap **only**: the charged words — the verb, the intensifier, the noun carrying the emotion. `power_word_frequency` in the mined JSON tells you which ones are earning their keep in *your* niche. Pull replacements from there, not from a thesaurus. ``` proven: "You're using Claude wrong" [contrarian · you're + wrong] ✅ "You're prompting Claude backwards" swapped the verb + the charge word ✅ "You're building agents the slow way" same skeleton, same tension ❌ "Many people use Claude incorrectly" psychology gone, flat English → slop ❌ "You're using Claude wrong" verbatim copy → plagiarism, the platform buries it ``` Then hand the winners to **viral-hook-writer** to rank, or straight into **reel-scripter**. ## Hard rules - **Never ship a mined hook verbatim.** It is someone else's line. Instagram's originality systems bury copies, and it's plagiarism. Model the technique, write your own words. - **Never remix the structure.** Change the clause order or drop the number and you have thrown away the only thing the data proved. - **A number in the source stays a number in the remix — and it must be YOURS and real.** Swapping in a stat you cannot defend is the fastest way to lose an audience. - **Rank before you mine.** Remixing a hook that did not perform just launders a bad idea. - **Small buckets are signal.** A pattern with two entries that both went viral beats one with forty mediocre ones. Weight by performance, not by count. ## Failure modes | Symptom | Cause | Fix | |---|---|---| | Variants read flat / corporate | rewrote the sentence instead of swapping words | restore the original skeleton, change only the charged words | | All variants sound identical | swapped one word in one slot | vary the slot — verb, intensifier, or emotional noun | | Variants lost the tension | resolved the curiosity gap inside the hook | the gap stays open; the payoff belongs after the hook | | Nothing outperforms | mining unranked or off-niche data | re-export ranked, filter to the actual niche | ## Where it sits `agent-reach` / `reel-analyzer` find what's working → **hook-mining** turns that data into your own hooks → `viral-hook-writer` ranks → `reel-scripter` writes the script → `reel-builder` builds it.
Files in this package (2)
- SKILL.md 5 KB
- mine_hooks.py 7 KB
Versions
The database has no other skills named hook-mining.
Database snapshot: 13.11.2026 · package version a72e85872e06 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100viral-hook-creator
Generates OR grades viral social media hooks using a library of proven patterns, structures, a swipe file, and trigger words. Trigger on "/viral-hook-creator", "write viral hooks for <topic>", "draft hook options for <topic>" (GENERATE mode), or "grade this hook", "is this hook… - 100viral-hook-creator
Creates viral social media hooks using proven psychological patterns and trigger words. Use when user needs attention-grabbing openings for posts, threads, videos, or content. - 90hook-writer
Use when writing or fixing the hooks for a video (the first 3 seconds), the super hook, the stacks, or the on-screen text hook. - 100viral-hook-writer
Write scroll-stopping hooks for a short-form video (the first 1-3 seconds). Use when the user says "hook", "reel hook", "opening line", "scroll stopper", "first three seconds", "TikTok hook", or "how do I start this video". - 100linkedin-hook-generator
Generate 10 LinkedIn hooks for a given topic, using proven hook patterns (curiosity, contrarian, number, question, tension, before-after, callout). Returns a ranked list with the strongest hook first. Use when the user has a draft but the opening line is weak, or when they want… - 100viral-hooks
Write and score scroll-stopping hooks for Reels, carousels and captions: the first 1-3 seconds or the first line, spoken and on-screen, built from 30 proven formulas and ranked by a local hook scorer. Use when the creator asks for "a hook", "hooks for this", "how should I start…