ig-hook-extractor

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