--- name: ig-hook-extractor description: Reverse-engineer the hook from a viral Instagram Reel or carousel, given a URL or a pasted caption. Identifies which of the 10 canonical 2026 formulas it uses (number-first, contrarian, relatable, confession, listicle, before/after, myth-buster, framework, pattern-interrupt Reel, how-I Reel), explains why it worked, names the primary goal, and returns a blank template mapped to your topic. Use to learn from a post you admire. Not for writing your own (use ig-caption-writer or ig-carousel-planner). ---

# Instagram Hook Extractor

Paste a viral Reel or carousel URL (or the caption text). Get back: which hook formula it uses, the exact structure, why it worked, the primary goal it chased, and a blank template you can fill with your own voice.

## When to use

- User finds a viral Reel or carousel they want to study - User wants to replicate a specific creator's pattern - Before `ig-caption-writer` or `ig-carousel-planner`, to seed a draft with a proven shape

## Input

An Instagram URL (`/p/`, `/reel/`, or a profile) or pasted caption + slide text. This bundle has no built-in Instagram reader, so for a URL the skill asks the user to paste the caption (and the on-image slide text for a carousel, or a quick description of the Reel's first 3 seconds).

## Output

- **Formula identified** (IG1-IG10 from `../../references/hook-formulas.md`) with a confidence score - **Surface:** single image, carousel, or Reel, and why that surface fit the idea - **Structural breakdown:** - The hook (caption first 125 chars / carousel slide 1 / Reel first 3 seconds) - Body architecture (per-slide roles for a carousel; beat order for a Reel) - The close (what earns the save, send, or follow) - Reaction-triggering devices (numbers, named entities, the open loop) - **Primary goal** the original chased (saves / shares / comments / follows) - **Why it worked** psychologically and algorithmically - **Blank template** with `{slot}` markers matched to the original, ready for the user's topic - **Cautions:** anything in the original that would fail a 2026 audit (em dashes, AI vocab, 30 hashtags, mixed media)

## Steps

1. **Parse the URL.** `lib.url_parser.parse_instagram_url(url)` returns `username`, `shortcode`, `url_type`. 2. **Get the content.** Ask the user to paste the caption, and for a carousel the slide text, or for a Reel the first 3 seconds (on-screen text + opening line). (If they later wire an Apify Instagram actor, read it automatically.) 3. **Detect the surface.** Single image, carousel, or Reel. 4. **Classify against the 10 formulas** using features: - Caption: an odd-precision result (IG1)? a contrarian claim (IG2)? a relatable moment (IG3)? a first-person confession (IG4)? - Carousel: a numbered teaching list (IG5)? a before/after (IG6)? a myth/truth structure (IG7)? a named framework (IG8)? - Reel: a pattern interrupt in the first seconds (IG9)? a "how I" teardown (IG10)? 5. **Score confidence.** If two formulas fit, return the top 2 with fit scores. 6. **Extract structure.** Label each part by its role. For a carousel, map slide 1 (the loop), the front-loaded value, and the payoff slide. 7. **Name the primary goal** the original optimized for. 8. **Generate a blank template** with `{slot}` markers matched to the original shape and the user's topic. 9. **Audit the source.** Flag any AI tells so the user does not copy them.

## Example

See `references/examples.md` for worked teardowns.

## Formulas reference

See `../../references/hook-formulas.md` for the 10 canonical Instagram formulas with full skeletons and goal tags.

## Files

- `SKILL.md` - this file - `references/classification-rules.md` - feature extraction + scoring heuristics - `references/examples.md` - worked teardowns (caption, carousel, Reel)

## Related skills

- `ig-caption-writer` - use the extracted caption template to draft your own - `ig-carousel-planner` - use the extracted carousel template - `ig-humanizer --mode audit` - audit your draft before shipping