sergebulaev/x-skills · Archived

x-hook-extractor

Reverse-engineer the hook from a viral X (Twitter) tweet or thread URL.

Installation

$ npx skills add sergebulaev/x-skills --skill x-hook-extractor

Summary

  • Reverse-engineer the hook from a viral X (Twitter) tweet or thread URL.
  • Identifies which of the 10 canonical 2026 X formulas it uses (one-liner contrarian, data-point, build-in-public, quote-tweet, mini-list, relatable cold-open, listicle-thread, story thread, curiosity-gap, how-I teardown), explains why it worked, and returns a blank template mapped to your topic with its primary goal.
  • Use to learn from a tweet you admire.
  • Not for writing your own (use x-post-writer or x-thread-builder).

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from sergebulaev/x-skills.

npx skills add sergebulaev/x-skills

Browse all from sergebulaev/x-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 65
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,853 B
  • docs SUMMARY.md 517 B

History

  1. First recorded snapshot · 2 installs

SKILL.md

X Hook Extractor

Paste a viral tweet or thread URL. Get back: which hook formula it uses, the exact structure, why it worked, and a blank template you can fill with your own voice.

When to use

  • User finds a viral tweet or thread they want to study
  • User wants to replicate a specific creator's pattern
  • Before x-post-writer or x-thread-builder, to seed a draft with a proven shape

Input

An X tweet or thread URL (x.com or twitter.com, /status/<id>). For a thread, the URL of the first tweet is best.

Output

  • Formula identified (X1-X10 from ../../references/hook-formulas.md) with a

confidence score

  • Container: single tweet vs thread, and why that container fit the idea
  • Structural breakdown:

- The hook line (and for a thread, how tweet 1 opens the loop) - Body architecture (per-tweet roles for a thread) - The close (what earns the repost or bookmark) - Reaction-triggering devices (numbers, named entities, the open loop)

  • Primary goal the original chased (replies / reposts / likes / bookmarks)
  • 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 (more

than one em dash in a tweet, an AI-vocab cluster, 3+ hashtags, link in tweet 1)

Steps

  1. Parse the URL. lib.urlparser.parsex_url(url) returns handle,

tweetid, urltype.

  1. Get the text. This bundle has no built-in tweet reader, so ask the user to

paste the tweet or the full thread text. (If they later wire an Apify tweet actor, read it automatically.)

  1. Detect the container. One self-contained tweet, or a multi-tweet thread.
  2. Classify against the 11 formulas using features:

- Single tweet: a flat contrarian claim (X1)? one hard number (X2)? a personal metric/confession (X3)? a quote tweet adding a layer (X4)? a one-line-per- item list (X5)? a relatable shared moment (X6)? - Thread: a numbered teaching promise (X7)? a story starting at the tension (X8)? a surprising result with the mechanism withheld (X9)? a first-person "how I" teardown (X10)?

  1. Score confidence. If two formulas fit, return the top 2 with fit scores.
  2. Extract structure. Label each part by its role. For a thread, map tweet 1

(the loop), the front-loaded payoff, the body beats, and the closer.

  1. Name the primary goal the original optimized for.
  2. Generate a blank template with {slot} markers matched to the original

shape and the user's topic.

  1. Audit the source. Flag any AI tells in the original so the user does not

copy them.

Example

See references/examples.md for worked teardowns.

Formulas reference

See ../../references/hook-formulas.md for the 11 canonical X 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 (single tweet and thread)

Related skills

  • x-post-writer - use the extracted single-tweet template to draft your own
  • x-thread-builder - use the extracted thread template
  • x-humanizer --mode audit - audit your draft before shipping