Skip to content
Skills Library
Marketing & content · Writing

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.

Licence
MIT
Last repository change
07.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

mine hooksremix hookshook variationsmake hooks from this CSVgive me hook options from what. NOT for inventing hooks from nothing — that

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. 1. Get real hooks in
  2. 2. Mine it
  3. 3. Remix — the part that matters
  4. Hard rules
  5. Failure modes
  6. Where it sits
Original SKILL.md headings · 82 lines, 644 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.