Copywriting hooks skill

Writes opening hooks and post titles for long-form articles in EN or FR — blog posts, Substack/Medium/dev.to, LinkedIn long-form, newsletters, essays.

by samber·MIT license·GitHub ↗

★ 222 Stars on the repo·Checked

npx degit samber/cc-skills/skills/copywriting-hooks#main ~/.claude/skills/copywriting-hooks

SKILL.md · 26.7 KB · installs the whole folder to ~/.claude/skills/copywriting-hooks

Files of Copywriting hooks

Files 1 file
Show the full text485 lines

Copywriting Hooks

The method

A hook's only job is to make the reader want sentence 2. Voice, structure, formatting, all of it, follow from that one job.

What makes a reader want sentence 2 is one of five levers:

  1. Open a gap. Pose something incomplete that the reader needs to close. Curiosity gap, question, open loop.
  2. Break a prediction. State something that violates the reader's prior. Contrarian, definition reversal, surprising statistic.
  3. Drop into a scene. Load sensory or specific detail that builds a vivid frame. In medias res, concrete detail, time anchor.
  4. Promise a payoff. Name an outcome the reader wants. Benefit, "if you... then this", direct problem.
  5. Borrow weight. Lean on a name, number, or quote that carries embedded authority. Authority hook, statistic, quote with disagreement.

A strong hook usually pulls two levers at once. "Frank Sinatra, holding a glass of bourbon..." is scene plus open loop. "Most people think X. They're wrong." is prediction-break plus gap. Single-lever hooks can still work but are easier to ignore.

Three further principles:

  • Specific beats abstract every time. Replace "many companies" with "Stripe, Shopify, Vercel". Replace "recently" with a date. Replace "studies show" with the actual finding or cut the claim.
  • The first sentence must force the second. Read each candidate cold. If you would not click sentence 2 after sentence 1, rewrite.
  • Match technique to article type. Personal essay does not open like a tutorial. See the type-fit table below.

Behavior

When this skill triggers:

  1. Confirm the brief. Topic, audience, target language (EN, FR, or both), approximate length, where it will be published. If any of these is unclear and material, ask before generating.
  2. Pick 3 to 4 hooks from the catalog below that are genuinely different. Different levers, not three flavors of contrarian.
  3. Write 2 candidates per hook, specific to the user's article. The two candidates within one hook should explore different angles (different anecdote, different statistic, different scene), not be rewordings of each other.
  4. Present using the Output format below.
  5. Ask through the question tool. The choice is a small fixed set, which is what that tool is for.
  6. Wait for the user's pick. Do not pick for them.
  7. After they pick, name what the choice commits the rest of the article to. A contrarian hook commits paragraphs 2 to 3 to defending the non-consensus claim. A scene opener commits the next section to either resolving the scene or productively delaying it.

Diversification rule. Across your 3 to 4 options include at minimum:

  • One intellectual hook (contrarian, definition reversal, historical analogy, curiosity gap)
  • One sensory hook (in medias res, concrete detail)
  • One reader-direct hook (conditional, direct problem, promise)

This guarantees real choice. Three flavors of contrarian is not a choice.

Type-fit reference:

Article type Strong hooks Avoid
Technical deep-dive concrete detail, statistic, contrarian, direct problem personal confession, scene opener
Personal essay in medias res, personal confession, time anchor, definition reversal bold claim, direct problem
Opinion / contrarian bold claim, definition reversal, contrarian, quote + disagreement gentle setup, dictionary opener
Tutorial / how-to direct problem (PAS), promise, conditional scene opener, historical analogy
Reported / investigative concrete detail, time anchor, in medias res, statistic bold claim, definition reversal
Listicle curiosity gap, counted stakes, conditional personal confession, in medias res
Longform analysis historical analogy, statistic, contrarian direct problem
Newsletter issue personal confession + open loop, conditional, curiosity gap dictionary opener

Output format

Always present options exactly like this:

## Hook options for: [working title]

**Option 1: [Hook name]** ([lever])
A. [Candidate 1]
B. [Candidate 2]

**Option 2: [Hook name]** ([lever])
A. [Candidate 1]
B. [Candidate 2]

**Option 3: [Hook name]** ([lever])
A. [Candidate 1]
B. [Candidate 2]

Which? Reply with letter combination (e.g., "1B") or "more" for different techniques.

If the user says "more" or "none", produce 3 different hooks (not new candidates for the same hooks). If the user says "blend 1A and 2B", write a combined hook and check in again.


The hook catalog (18)

Each hook: what it does, examples (mix EN and FR, real and illustrative), when to use, when to avoid.

1. Curiosity Gap

Open an information gap the reader wants closed.

  • EN: "How does Shen Yun make any money? Short answer: they don't." (Packy McCormick)
  • EN: "Many years ago, one mustard dominated the supermarket shelves: French's." (Gladwell, "The Ketchup Conundrum")
  • FR: "Trois startups françaises ont franchi le milliard cette année. Aucune n'est dans la tech."
  • EN: "I've been a surgeon for eight years. For the past couple of them, my performance in the operating room has reached a plateau." (Gawande)

Use when: you can honestly close the gap in 2 or 3 sentences. The gap must be one the reader cares about. Avoid: vague gaps ("You won't believe what happened next") that the reader cannot even guess at.

2. Contrarian

Knock down a consensus belief the reader holds.

  • EN: "Prevailing wisdom claims that the best way to achieve what we want in life is to set specific, actionable goals." (Clear, "Forget About Setting Goals", proceeds to argue the opposite)
  • EN: "To do something well you have to like it. That idea is not exactly novel." (Graham, "Do What You Love", proceeds to complicate it)
  • EN: "If you're not saying 'HELL YEAH!' about something, say no." (Sivers)
  • FR: "Le Marketing est TOUT ce que l'IA ne peut pas faire !" (Truphème)

Use when: you have a defensible non-consensus view and 200 to 400 words to defend it. Avoid: strawmen, gratuitous edginess, contrarianism for its own sake.

3. Bold Claim / Promise

State the outcome upfront, before the proof.

  • EN: "At 60 miles an hour the loudest noise in this new Rolls-Royce comes from the electric clock." (Ogilvy)
  • EN: "They laughed when I sat down at the piano. But when I started to play!—" (Caples 1925)
  • EN: "Give me 15 minutes and I'll give you a super-power memory." (Schwartz)
  • FR: "En 5 minutes : la structure qui fait passer le taux de complétion d'un article de 18% à 64%."

Use when: you can deliver on the promise concretely in the article. Avoid: promises larger than the payoff. Destroys trust permanently.

4. Scene Opener / In Medias Res

Drop the reader inside a specific moment, no setup.

  • EN: "Frank Sinatra, holding a glass of bourbon in one hand and a cigarette in the other, stood in a dark corner of the bar between two attractive but fading blondes who sat waiting for him to say something." (Talese)
  • EN: "We were somewhere around Barstow on the edge of the desert when the drugs began to take hold." (Thompson)
  • EN: "The center was not holding." (Didion)
  • FR: "Le 14 mai 2024, à 6h12, trois hommes en civil sonnent à la porte d'un appartement du XVe arrondissement."

Use when: longform, profile, reported piece, essay. Avoid: short technical pieces where the reader has not earned the scene yet.

5. Surprising Statistic

Lead with a number that violates the prior.

  • EN: "You have five seconds to get people's attention." (Housel, self-demonstrating)
  • EN: "Thirty-seven thousand Americans died in car accidents in 1955, six times today's rate adjusted for miles driven." (Housel)
  • EN: "Approximately 40 percent of the actions you perform each day are habits, not actual decisions." (Clear)
  • FR: "Tu as moins de 3 secondes pour convaincre tes audiences que ton contenu est intéressant." (Truphème)

Use when: the number is genuinely surprising and you can cite it accurately. Avoid: vague stats ("studies show 90%..."), stats that confirm the reader's prior (no surprise equals no hook).

6. Question

Pose a question the reader actually wants answered.

  • EN: "If you collected lists of techniques for doing great work in a lot of different fields, what would the intersection look like?" (Graham)
  • EN: "Why do we make kids go to school?" (Caplan)
  • FR: "Pourquoi 80% des articles LinkedIn ne dépassent jamais 100 vues ? Spoiler : ce n'est pas l'algorithme."
  • FR: "Avez-vous le courage de gagner la moitié d'un million de dollars cette année ?" (Schwartz)

Use when: the reader was implicitly carrying the question. Avoid: "Have you ever wondered...?", "Did you know...?", "What if I told you...?". These presuppose curiosity not yet formed.

7. Quote + Disagreement

Borrow weight, then twist.

  • EN: "Vernor Vinge: 'We are on the edge of change comparable to the rise of human life on Earth.'" (Urban setup)
  • EN: "Steve Jobs said people don't know what they want until you show it to them. For SaaS, this is exactly backwards."
  • EN: "Henry Ford supposedly said his customers would have asked for faster horses. For most products, that excuse is wrong."
  • FR: "Henry Ford disait qu'on lui aurait demandé des chevaux plus rapides. Pour 90% des produits, c'est faux."

Use when: you have a real quote that supports or genuinely contrasts your point. Avoid: misattributed Einstein, Seneca, Confucius, Bouddha platitudes. Cliché.

8. Personal Confession

Admit something vulnerable, then universalize.

  • EN: "I cheated on my husband." (Strayed)
  • EN: "I've been thinking about my parents, who are in their mid-60s. During my first 18 years, I spent some time with my parents during at least 90% of my days." (Urban, "The Tail End")
  • EN: "It's been a minute. This is as long as I've gone without writing an essay since starting Not Boring." (McCormick)
  • FR: "À 34 ans, j'ai démissionné sans plan B. Voici ce que personne ne dit sur la suite."

Use when: personal byline, essay, newsletter. Avoid: corporate byline, technical articles where the author voice is not personal, performative vulnerability ("I almost didn't write this...").

9. Concrete Specific Detail

Replace abstraction with a single vivid detail.

  • EN: "John Laroche is a tall guy, skinny as a stick, pale-eyed, slouch-shouldered, and sharply handsome, despite the fact that he is missing all his front teeth." (Orlean)
  • EN: "Charles Bukowski was an alcoholic, a womanizer, a chronic gambler, a lout, a cheapskate, a deadbeat, and on his worst days, a poet." (Manson)
  • FR: "Quand on la voit arriver dans les locaux du Bondy Blog, ce samedi 24 février, difficile de se dire qu'elle est fichée illégalement par les services de renseignement français."
  • FR: "Un Post-it collé sur mon écran : 'Supprime ton premier paragraphe.'"

Use when: profile, reported piece, contrarian biographical setup. Avoid: specificity that does not advance the thesis (clutter).

10. Pattern Interrupt

Break expected rhythm with a fragment.

  • EN: "Wait." (Godin style)
  • EN: "Stop."
  • EN: "This is not an article about productivity. It's an article about identity."
  • FR: "Non. Ce que vous avez lu cette semaine sur l'IA est faux. Voici pourquoi."

Use when: rhythm-driven content, opinion piece, when the reader expects flow and you want to interrupt it. Avoid: every article. It becomes its own pattern fast.

11. Direct Problem (PAS)

Name the pain, sharpen it, hint at solution.

  • EN: "Your articles aren't read. The data says you lose 80% of readers by paragraph two. There's a fix, and it's not what you've been doing."
  • EN: "If you're like most marketing managers, you don't have enough time to write your white papers, and the ones you outsource come back generic." (Bly)
  • FR: "Vos emails ne sont pas ouverts. Trois mois, taux plafonné à 12%. Le problème n'est pas l'objet, c'est l'expéditeur."
  • FR: "Vos articles ne sont pas lus. 80% des lecteurs décrochent dès le deuxième paragraphe. Et la solution n'est pas celle que vous croyez."

Use when: tutorial, how-to, sales-adjacent content. Avoid: manufactured problems. Reads as fear-mongering. The pain must be real and recognizable.

12. Promise / Benefit

State a specific, bounded outcome.

  • EN: "Read this in 5 minutes and you'll never write a weak opening again."
  • EN: "By the end of this article, you'll know exactly when to use goroutines and when not to."
  • EN: "Three things separate writers who get read from writers who don't. None involve writing every day."
  • FR: "En 5 minutes : la structure qui fait passer le taux de complétion d'un article de 18% à 64%."

Use when: tutorial, how-to. Avoid: vague promises ("Learn how to be more productive"). Add a time bound or a number to anchor it.

13. Historical Analogy

Open with a vignette from history, pivot to the present.

  • EN: "On a Tuesday morning in March 1976, a 21-year-old college dropout sold his Volkswagen Bus for 1,500 dollars. He used the money to build the first Apple computer."
  • EN: "In 1965, Robert Lucas wrote a four-page paper that broke macroeconomics."
  • EN: Wright Brothers vignette (Housel, "Three Big Things"), pivots to demographics and interest rates.
  • FR: "En 1903, à Kitty Hawk, deux frères réparateurs de vélos volent pendant 12 secondes. Personne ne remarque. Voici ce que cette indifférence dit de l'adoption technologique aujourd'hui."

Use when: longform analysis, opinion piece, idea essay. Avoid: tutorials, news pieces. Reads as indulgent.

14. Definition Reversal

"X is not what you think. It's Y."

  • EN: "Procrastination isn't laziness. It's a fight between two parts of your brain."
  • EN: "This is not an article about productivity. It's an article about identity."
  • EN: "Generics were the most requested Go feature for a decade. Three years in, the people who pushed hardest for them are telling you to stop using them."
  • FR: "Le copywriting n'est pas de l'écriture. C'est de la psychologie déguisée en phrases."

Use when: opinion piece, contrarian deep dive. Avoid: when your reframe is just a slight angle. Sounds gimmicky.

15. Authority Borrow

Lead with a name plus a specific action.

  • EN: "Warren Buffett, at 91, still reads 500 pages a day."
  • EN: "When Steve Jobs returned to Apple in 1997, he killed 70% of the product line in his first year."
  • EN: "A boy once asked Charlie Munger..." (Housel narrative variant)
  • FR: "Quand Bernard Arnault a racheté Tiffany pour 16 milliards, trois analystes ont prédit un échec. Ils s'étaient tous trompés sur la même chose."

Use when: business piece, profile, analytical essay. Avoid: name-dropping without payoff. The action must be specific and relevant.

16. Time Anchor

Lead with a specific date, hour, or moment.

  • EN: "October 2005. Three journalists set up a blog in an apartment of the cité Blanqui, in Bondy."
  • EN: "In 2022, the cost of writing a competent article dropped to zero. Most writers haven't noticed."
  • EN: "On a Tuesday morning in March 1976, a 21-year-old dropout sold his Volkswagen Bus for 1,500 dollars."
  • FR: "Octobre 2005, Bondy. Trois journalistes installent un blog dans un appartement de la cité Blanqui."

Use when: reported piece, retrospective, "why now" framing. Avoid: vague time anchors ("recently", "these past few years"). Use a specific date or cut the time framing.

17. Conditional ("If you... then this")

Self-segment the reader. Pre-target the curiosity.

  • EN: "If you write for a living, you've probably been taught to start with context. Don't."
  • EN: "If you've ever read a blog post and forgotten what it said within the hour, this article is the diagnostic."
  • EN: "If you're not saying 'HELL YEAH!' about something, say no." (Sivers)
  • FR: "Si vos articles sont lus à 80% par vos collègues et à 8% par vos prospects, le problème n'est pas le contenu. C'est l'accroche."

Use when: tutorial, advice piece, segmented audience. Avoid: conditions too broad ("If you've ever felt stuck..."). Segments nobody.

18. Open Loop

Start something, withhold the resolution.

  • EN: Talese's Sinatra waiting for him to say something. He never says.
  • EN: "He pressed Send and waited. Forty-seven seconds later, the company was worth 4 billion dollars less."
  • EN: "Now here's where it gets really interesting..." (Sugarman, transition phrase, also valid as opener)
  • FR: "J'ai été contacté par un éditeur la semaine dernière. Ce qu'il m'a demandé m'a fait reconsidérer 15 ans de pratique."

Use when: longform, pieces where the journey matters as much as the answer. Avoid: unresolved loops. Creates disproportionate betrayal when the article ends without paying off.


Anti-patterns (never propose any of these)

Cliché openers that immediately disqualify the writer:

  • "In today's fast-paced world..." / "À l'heure du tout-numérique" / "À l'ère de l'IA" / "Dans un monde où..."
  • "Have you ever wondered...?" / "Vous êtes-vous déjà demandé...?"
  • Dictionary opener played straight ("Productivity, defined as...")
  • "In this article, I'll discuss..." / "Dans cet article, nous allons voir..."
  • Generic stats without source ("90% of people...", "Les études montrent...")
  • Misattributed Einstein / Seneca / Confucius / Bouddha quotes
  • "I'm not an expert, but..." / "Je ne suis pas spécialiste mais..."
  • Three rhetorical questions in a row
  • "Imagine waking up..." without a specific scene
  • "Hot take:", "Unpopular opinion:", "Voici la vérité que personne ne veut entendre..."
  • "At [Company], we believe..." / "Chez [Entreprise], nous pensons..."
  • "Recently,..." / "Récemment,..." without a specific date
  • "You're not alone."

Current AI tells (refresh yearly):

  • "It's not just X, it's Y" (the formula construction)
  • "Picture this:", "Imagine a world where...", "What if I told you..."
  • "Whether you're a seasoned X or a curious newcomer..."
  • "In the realm of...", "Navigating the landscape of..."
  • "Unlock the power of...", "Dive into...", "Buckle up,", "Let's dive in"
  • "Crucially,", "Notably,", "Importantly,", "Essentially," as sentence openers
  • French AI tells: "Dans un monde en constante évolution", "Plongez dans...", "Découvrez comment...", "Par ailleurs,...", "Notamment,...", "Il est crucial de..."

Run every candidate through this list before presenting. If a candidate matches, rewrite.

For the extended anti-pattern list, see references/anti-patterns.md.


Language handling

If the audience is French: write in French, applying the attaque journalistique register.

  • Concrete scene-setting, restrained tone, dated anchors, formal "vous" or restrained tutoiement.
  • Do not translate American hype tropes literally — "You'll never believe..." becomes "Vous n'allez pas en croire vos yeux", which reads as scam in French.
  • French marketing-skepticism baseline is higher than English; high promises trigger réactance faster.

If English: default to direct-response register for marketing or tutorial content, longform register for essays and reported pieces.

If bilingual: produce hooks in both languages, label clearly.

For deeper register guidance, see references/anglophone-vs-francophone.md.


Post Titles

A title is what the reader sees before clicking. A hook is what they read after. Both earn attention through different mechanisms: the title competes for clicks in a feed or search result; the hook earns continued reading after the click.

The core mechanic: calibrated curiosity

A title must open a gap without closing it — but the gap must feel real, not manufactured. Research on 8,977 A/B experiments (Upworthy, Scientific Reports 2024) found a curvilinear relationship: too vague produces confusion (no foothold for curiosity); too specific removes motivation to click. The sweet spot: name the stakes, withhold the resolution.

The craft test. Does the title open a gap the reader cares about, and does the article genuinely close it? If yes, that's craft. If the content doesn't deliver what the title implied, that's clickbait — it destroys trust for future clicks.

Core formulas

Curiosity / Gap

  • The [Adjective] Truth About [Topic] — "The Counterintuitive Truth About Go Generics"
  • What [Group] Won't Tell You About [Topic]
  • The Real Reason [Phenomenon] — "The Real Reason Most Content Gets Zero Shares"
  • [Number] Things Every [Audience] Gets Wrong About [Topic]

Contrarian / Negative (negative superlatives: +63% CTR vs. positive — Outbrain, 65k titles)

  • Stop [Doing X]. Here's Why. / Why [Common Belief] Is Wrong
  • [Number] [Myths/Mistakes] That Are Killing Your [Result]

Specificity / Data

  • I Analyzed [Number] [Things] — Here's What I Found
  • [Number]% of [Group] Does This Wrong
  • Brackets signal format honestly and add +38% CTR: How I Cut Build Time by 60% [Benchmark]

List / Number (numbers: +36% CTR — Conductor; odd numbers: +20% CTR — CMI)

  • [Number] [Adjective] Ways to [Goal] / [Number] Mistakes to Avoid When [Task]

How-To (3× more B2B shares than other formats — BuzzSumo, 10M LinkedIn articles)

  • How to [Task] Without [Painful Constraint] / How to [Task] Even If [Limiting Belief]
The "putaclic léger" zone

Slightly clickbait but honest — maximum tension with a real promise:

  • Replace "won't believe" → "surprised to learn": same curiosity, honest register
  • Add specificity: "I saved €500/month" beats "I saved money"
  • Add a constraint: "without quitting your job" creates the gap
  • Use "the real reason" or "what nobody tells you" — they signal a non-consensus view you must substantiate
  • Add a bracket [Étude], [Template], [Benchmark] to signal payoff type

FR — putaclic carries stronger pejorative weight. Apply the 70/30 rule: 70% information, 30% mystery.

  • Tension and contradiction work; faux drama ("J'arrête tout 😱") destroys credibility immediately in French professional contexts.
  • Canonical FR structure: "Tout le monde vous dit de faire A. Voici pourquoi je fais B."
  • Formulas saturated on LinkedIn FR in 2025+: "J'ai fait une erreur, voici ce que j'ai appris", "J'arrête [plateforme]".
Platform constraints
Platform Max display Key rule
Blog / SEO 50–60 chars Front-load keyword. Power words reduce CTR by ~14% in search.
LinkedIn article 150 chars hard Under 100 for clean display.
LinkedIn feed 120–140 chars Opening line = the title. Engineer a "see more" click.
Newsletter subject 30–50 chars First 30 chars carry the signal. Avoid "Newsletter" (−18.7% opens).
X / Twitter ≤200 chars First tweet = the title. Must stand alone.
Anti-patterns for titles
  • Generic superlatives without specificity: "The Ultimate Guide to X" — no gap
  • "You won't believe..." / "Vous n'allez pas y croire..." — overused, signals hype
  • Power words (Secret, Amazing, Ultimate) in SEO titles — signal hype, lower CTR
  • Titles that give away the full answer — if the title answers the question, there is no reason to click
  • Recycling saturated fingerprints: "I analyzed X things, here's what I found" — effective 2022–2023, saturating 2025–2026
Behavior for title requests
  1. Confirm topic, audience, language, platform
  2. Propose 3–5 titles across distinct formulas — not three variants of the same type
  3. Include at minimum: one curiosity/gap, one contrarian or data, one list or how-to
  4. Use the same output format as hooks: numbered options, wait for the pick
  5. After the pick, note what the title commits the article's opening to

For the full 58-formula catalog (EN + FR) with data citations, see references/title-formulas.md.


Reference files (load only when needed)

  • references/anti-patterns.md: extended cliché and AI-tell list.
  • references/anglophone-vs-francophone.md: register conventions, what does not translate.
  • references/formulas.md: 30 reusable templates (EN + FR) for quick template-based hooks.
  • references/title-formulas.md: 58-formula post title catalog (EN + FR), platform constraints table, data summary.

The catalog above is sufficient for most invocations. Load references only when the user asks for templates, deeper register guidance, or to sanity-check anti-patterns.


Integration with other ghostwriting skills

If invoked from inside another skill's workflow (e.g., technical-article-writer reaches the hook step), produce options, ask, wait. Return the chosen hook to the parent skill for the rest of the article.

If the user has already drafted an opening and asks for "a better one", treat that draft as Option 0 (their current version) and propose 3 alternatives across different hooks. Do not silently discard their version.


Worked example

User: "I'm writing a Substack piece on why most Go developers misuse generics. About 1500 words, intermediate Go devs, English."

Correct skill response:

## Hook options for: "Why Most Go Developers Misuse Generics"

**Option 1: Contrarian** (prediction-break)
A. Most articles on Go generics explain when to use them. This one explains when to delete them.
B. Generics were the most requested Go feature for a decade. Three years in, the people who pushed hardest for them are the ones telling you to stop using them.

**Option 2: Concrete detail** (sensory + specific)
A. samber/lo ships 87 generic helpers. Six of them account for 94 percent of the binary-size complaints. The other 81 are fine.
B. A function called `Map[T, U any]` looks innocent. Compile a project that imports it 40 times and your build time triples. Here is why.

**Option 3: Direct problem (PAS)** (reader-direct)
A. Your Go code compiles slower since you adopted generics. The cause is not what the linter is telling you.
B. If your team adopted generics last year and your build times doubled, you are not alone. The diagnosis is more boring than the fix.

Which? Reply with letter combination (e.g., "1B") or "more" for different techniques.

Then wait for the pick. Do not write the rest of the article until the user has chosen.

1---
2name: copywriting-hooks
3description: >
4 Writes opening hooks and post titles for long-form articles in EN or FR — blog posts, Substack/Medium/dev.to, LinkedIn long-form, newsletters, essays. Trigger whenever the user asks for a hook, opening, lede, intro, first sentence/paragraph, opener, accroche, attaque, phrase d'accroche, or première phrase — including punching up a flat intro or draft opening — or for a post title, titre d'article, or headline. Do NOT trigger for social posts (LinkedIn feed, Twitter/X, TikTok, Bluesky), READMEs, taglines, email subjects, ad copy, landing-page headlines, press releases, SEO meta, or body rewrites. Do NOT use for end-of-article CTAs — use samber/cc-skills@copywriting-cta instead.
5 
6user-invocable: true
7license: MIT
8compatibility: Designed for Claude Code, Codex or similar harness.
9metadata:
10 author: samber
11 version: "1.1.2"
12 openclaw:
13 emoji: "🪝"
14 homepage: https://github.com/samber/cc-skills
15allowed-tools: Read Edit Write Glob Grep Agent AskUserQuestion
16---
17 
18# Copywriting Hooks
19 
20## The method
21 
22A hook's only job is to make the reader want sentence 2. Voice, structure, formatting, all of it, follow from that one job.
23 
24What makes a reader want sentence 2 is one of **five levers**:
25 
261. **Open a gap.** Pose something incomplete that the reader needs to close. Curiosity gap, question, open loop.
272. **Break a prediction.** State something that violates the reader's prior. Contrarian, definition reversal, surprising statistic.
283. **Drop into a scene.** Load sensory or specific detail that builds a vivid frame. In medias res, concrete detail, time anchor.
294. **Promise a payoff.** Name an outcome the reader wants. Benefit, "if you... then this", direct problem.
305. **Borrow weight.** Lean on a name, number, or quote that carries embedded authority. Authority hook, statistic, quote with disagreement.
31 
32A strong hook usually pulls two levers at once. "Frank Sinatra, holding a glass of bourbon..." is scene plus open loop. "Most people think X. They're wrong." is prediction-break plus gap. Single-lever hooks can still work but are easier to ignore.
33 
34Three further principles:
35 
36- **Specific beats abstract every time.** Replace "many companies" with "Stripe, Shopify, Vercel". Replace "recently" with a date. Replace "studies show" with the actual finding or cut the claim.
37- **The first sentence must force the second.** Read each candidate cold. If you would not click sentence 2 after sentence 1, rewrite.
38- **Match technique to article type.** Personal essay does not open like a tutorial. See the type-fit table below.
39 
40---
41 
42## Behavior
43 
44When this skill triggers:
45 
461. **Confirm the brief.** Topic, audience, target language (EN, FR, or both), approximate length, where it will be published. If any of these is unclear and material, ask before generating.
472. **Pick 3 to 4 hooks from the catalog** below that are genuinely different. Different levers, not three flavors of contrarian.
483. **Write 2 candidates per hook**, specific to the user's article. The two candidates within one hook should explore different angles (different anecdote, different statistic, different scene), not be rewordings of each other.
494. **Present using the Output format** below.
505. **Ask through the question tool.** The choice is a small fixed set, which is what that tool is for.
516. **Wait for the user's pick.** Do not pick for them.
527. **After they pick**, name what the choice commits the rest of the article to. A contrarian hook commits paragraphs 2 to 3 to defending the non-consensus claim. A scene opener commits the next section to either resolving the scene or productively delaying it.
53 
54**Diversification rule.** Across your 3 to 4 options include at minimum:
55 
56- One intellectual hook (contrarian, definition reversal, historical analogy, curiosity gap)
57- One sensory hook (in medias res, concrete detail)
58- One reader-direct hook (conditional, direct problem, promise)
59 
60This guarantees real choice. Three flavors of contrarian is not a choice.
61 
62**Type-fit reference:**
63 
64| Article type | Strong hooks | Avoid |
65| --- | --- | --- |
66| Technical deep-dive | concrete detail, statistic, contrarian, direct problem | personal confession, scene opener |
67| Personal essay | in medias res, personal confession, time anchor, definition reversal | bold claim, direct problem |
68| Opinion / contrarian | bold claim, definition reversal, contrarian, quote + disagreement | gentle setup, dictionary opener |
69| Tutorial / how-to | direct problem (PAS), promise, conditional | scene opener, historical analogy |
70| Reported / investigative | concrete detail, time anchor, in medias res, statistic | bold claim, definition reversal |
71| Listicle | curiosity gap, counted stakes, conditional | personal confession, in medias res |
72| Longform analysis | historical analogy, statistic, contrarian | direct problem |
73| Newsletter issue | personal confession + open loop, conditional, curiosity gap | dictionary opener |
74 
75---
76 
77## Output format
78 
79Always present options exactly like this:
80 
81```
82## Hook options for: [working title]
83 
84**Option 1: [Hook name]** ([lever])
85A. [Candidate 1]
86B. [Candidate 2]
87 
88**Option 2: [Hook name]** ([lever])
89A. [Candidate 1]
90B. [Candidate 2]
91 
92**Option 3: [Hook name]** ([lever])
93A. [Candidate 1]
94B. [Candidate 2]
95 
96Which? Reply with letter combination (e.g., "1B") or "more" for different techniques.
97```
98 
99If the user says "more" or "none", produce 3 different hooks (not new candidates for the same hooks). If the user says "blend 1A and 2B", write a combined hook and check in again.
100 
101---
102 
103## The hook catalog (18)
104 
105Each hook: what it does, examples (mix EN and FR, real and illustrative), when to use, when to avoid.
106 
107### 1. Curiosity Gap
108 
109Open an information gap the reader wants closed.
110 
111- EN: "How does Shen Yun make any money? Short answer: they don't." (Packy McCormick)
112- EN: "Many years ago, one mustard dominated the supermarket shelves: French's." (Gladwell, "The Ketchup Conundrum")
113- FR: "Trois startups françaises ont franchi le milliard cette année. Aucune n'est dans la tech."
114- EN: "I've been a surgeon for eight years. For the past couple of them, my performance in the operating room has reached a plateau." (Gawande)
115 
116**Use when**: you can honestly close the gap in 2 or 3 sentences. The gap must be one the reader cares about. **Avoid**: vague gaps ("You won't believe what happened next") that the reader cannot even guess at.
117 
118### 2. Contrarian
119 
120Knock down a consensus belief the reader holds.
121 
122- EN: "Prevailing wisdom claims that the best way to achieve what we want in life is to set specific, actionable goals." (Clear, "Forget About Setting Goals", proceeds to argue the opposite)
123- EN: "To do something well you have to like it. That idea is not exactly novel." (Graham, "Do What You Love", proceeds to complicate it)
124- EN: "If you're not saying 'HELL YEAH!' about something, say no." (Sivers)
125- FR: "Le Marketing est TOUT ce que l'IA ne peut pas faire !" (Truphème)
126 
127**Use when**: you have a defensible non-consensus view and 200 to 400 words to defend it. **Avoid**: strawmen, gratuitous edginess, contrarianism for its own sake.
128 
129### 3. Bold Claim / Promise
130 
131State the outcome upfront, before the proof.
132 
133- EN: "At 60 miles an hour the loudest noise in this new Rolls-Royce comes from the electric clock." (Ogilvy)
134- EN: "They laughed when I sat down at the piano. But when I started to play!—" (Caples 1925)
135- EN: "Give me 15 minutes and I'll give you a super-power memory." (Schwartz)
136- FR: "En 5 minutes : la structure qui fait passer le taux de complétion d'un article de 18% à 64%."
137 
138**Use when**: you can deliver on the promise concretely in the article. **Avoid**: promises larger than the payoff. Destroys trust permanently.
139 
140### 4. Scene Opener / In Medias Res
141 
142Drop the reader inside a specific moment, no setup.
143 
144- EN: "Frank Sinatra, holding a glass of bourbon in one hand and a cigarette in the other, stood in a dark corner of the bar between two attractive but fading blondes who sat waiting for him to say something." (Talese)
145- EN: "We were somewhere around Barstow on the edge of the desert when the drugs began to take hold." (Thompson)
146- EN: "The center was not holding." (Didion)
147- FR: "Le 14 mai 2024, à 6h12, trois hommes en civil sonnent à la porte d'un appartement du XVe arrondissement."
148 
149**Use when**: longform, profile, reported piece, essay. **Avoid**: short technical pieces where the reader has not earned the scene yet.
150 
151### 5. Surprising Statistic
152 
153Lead with a number that violates the prior.
154 
155- EN: "You have five seconds to get people's attention." (Housel, self-demonstrating)
156- EN: "Thirty-seven thousand Americans died in car accidents in 1955, six times today's rate adjusted for miles driven." (Housel)
157- EN: "Approximately 40 percent of the actions you perform each day are habits, not actual decisions." (Clear)
158- FR: "Tu as moins de 3 secondes pour convaincre tes audiences que ton contenu est intéressant." (Truphème)
159 
160**Use when**: the number is genuinely surprising and you can cite it accurately. **Avoid**: vague stats ("studies show 90%..."), stats that confirm the reader's prior (no surprise equals no hook).
161 
162### 6. Question
163 
164Pose a question the reader actually wants answered.
165 
166- EN: "If you collected lists of techniques for doing great work in a lot of different fields, what would the intersection look like?" (Graham)
167- EN: "Why do we make kids go to school?" (Caplan)
168- FR: "Pourquoi 80% des articles LinkedIn ne dépassent jamais 100 vues ? Spoiler : ce n'est pas l'algorithme."
169- FR: "Avez-vous le courage de gagner la moitié d'un million de dollars cette année ?" (Schwartz)
170 
171**Use when**: the reader was implicitly carrying the question. **Avoid**: "Have you ever wondered...?", "Did you know...?", "What if I told you...?". These presuppose curiosity not yet formed.
172 
173### 7. Quote + Disagreement
174 
175Borrow weight, then twist.
176 
177- EN: "Vernor Vinge: 'We are on the edge of change comparable to the rise of human life on Earth.'" (Urban setup)
178- EN: "Steve Jobs said people don't know what they want until you show it to them. For SaaS, this is exactly backwards."
179- EN: "Henry Ford supposedly said his customers would have asked for faster horses. For most products, that excuse is wrong."
180- FR: "Henry Ford disait qu'on lui aurait demandé des chevaux plus rapides. Pour 90% des produits, c'est faux."
181 
182**Use when**: you have a real quote that supports or genuinely contrasts your point. **Avoid**: misattributed Einstein, Seneca, Confucius, Bouddha platitudes. Cliché.
183 
184### 8. Personal Confession
185 
186Admit something vulnerable, then universalize.
187 
188- EN: "I cheated on my husband." (Strayed)
189- EN: "I've been thinking about my parents, who are in their mid-60s. During my first 18 years, I spent some time with my parents during at least 90% of my days." (Urban, "The Tail End")
190- EN: "It's been a minute. This is as long as I've gone without writing an essay since starting Not Boring." (McCormick)
191- FR: "À 34 ans, j'ai démissionné sans plan B. Voici ce que personne ne dit sur la suite."
192 
193**Use when**: personal byline, essay, newsletter. **Avoid**: corporate byline, technical articles where the author voice is not personal, performative vulnerability ("I almost didn't write this...").
194 
195### 9. Concrete Specific Detail
196 
197Replace abstraction with a single vivid detail.
198 
199- EN: "John Laroche is a tall guy, skinny as a stick, pale-eyed, slouch-shouldered, and sharply handsome, despite the fact that he is missing all his front teeth." (Orlean)
200- EN: "Charles Bukowski was an alcoholic, a womanizer, a chronic gambler, a lout, a cheapskate, a deadbeat, and on his worst days, a poet." (Manson)
201- FR: "Quand on la voit arriver dans les locaux du Bondy Blog, ce samedi 24 février, difficile de se dire qu'elle est fichée illégalement par les services de renseignement français."
202- FR: "Un Post-it collé sur mon écran : 'Supprime ton premier paragraphe.'"
203 
204**Use when**: profile, reported piece, contrarian biographical setup. **Avoid**: specificity that does not advance the thesis (clutter).
205 
206### 10. Pattern Interrupt
207 
208Break expected rhythm with a fragment.
209 
210- EN: "Wait." (Godin style)
211- EN: "Stop."
212- EN: "This is not an article about productivity. It's an article about identity."
213- FR: "Non. Ce que vous avez lu cette semaine sur l'IA est faux. Voici pourquoi."
214 
215**Use when**: rhythm-driven content, opinion piece, when the reader expects flow and you want to interrupt it. **Avoid**: every article. It becomes its own pattern fast.
216 
217### 11. Direct Problem (PAS)
218 
219Name the pain, sharpen it, hint at solution.
220 
221- EN: "Your articles aren't read. The data says you lose 80% of readers by paragraph two. There's a fix, and it's not what you've been doing."
222- EN: "If you're like most marketing managers, you don't have enough time to write your white papers, and the ones you outsource come back generic." (Bly)
223- FR: "Vos emails ne sont pas ouverts. Trois mois, taux plafonné à 12%. Le problème n'est pas l'objet, c'est l'expéditeur."
224- FR: "Vos articles ne sont pas lus. 80% des lecteurs décrochent dès le deuxième paragraphe. Et la solution n'est pas celle que vous croyez."
225 
226**Use when**: tutorial, how-to, sales-adjacent content. **Avoid**: manufactured problems. Reads as fear-mongering. The pain must be real and recognizable.
227 
228### 12. Promise / Benefit
229 
230State a specific, bounded outcome.
231 
232- EN: "Read this in 5 minutes and you'll never write a weak opening again."
233- EN: "By the end of this article, you'll know exactly when to use goroutines and when not to."
234- EN: "Three things separate writers who get read from writers who don't. None involve writing every day."
235- FR: "En 5 minutes : la structure qui fait passer le taux de complétion d'un article de 18% à 64%."
236 
237**Use when**: tutorial, how-to. **Avoid**: vague promises ("Learn how to be more productive"). Add a time bound or a number to anchor it.
238 
239### 13. Historical Analogy
240 
241Open with a vignette from history, pivot to the present.
242 
243- EN: "On a Tuesday morning in March 1976, a 21-year-old college dropout sold his Volkswagen Bus for 1,500 dollars. He used the money to build the first Apple computer."
244- EN: "In 1965, Robert Lucas wrote a four-page paper that broke macroeconomics."
245- EN: Wright Brothers vignette (Housel, "Three Big Things"), pivots to demographics and interest rates.
246- FR: "En 1903, à Kitty Hawk, deux frères réparateurs de vélos volent pendant 12 secondes. Personne ne remarque. Voici ce que cette indifférence dit de l'adoption technologique aujourd'hui."
247 
248**Use when**: longform analysis, opinion piece, idea essay. **Avoid**: tutorials, news pieces. Reads as indulgent.
249 
250### 14. Definition Reversal
251 
252"X is not what you think. It's Y."
253 
254- EN: "Procrastination isn't laziness. It's a fight between two parts of your brain."
255- EN: "This is not an article about productivity. It's an article about identity."
256- EN: "Generics were the most requested Go feature for a decade. Three years in, the people who pushed hardest for them are telling you to stop using them."
257- FR: "Le copywriting n'est pas de l'écriture. C'est de la psychologie déguisée en phrases."
258 
259**Use when**: opinion piece, contrarian deep dive. **Avoid**: when your reframe is just a slight angle. Sounds gimmicky.
260 
261### 15. Authority Borrow
262 
263Lead with a name plus a specific action.
264 
265- EN: "Warren Buffett, at 91, still reads 500 pages a day."
266- EN: "When Steve Jobs returned to Apple in 1997, he killed 70% of the product line in his first year."
267- EN: "A boy once asked Charlie Munger..." (Housel narrative variant)
268- FR: "Quand Bernard Arnault a racheté Tiffany pour 16 milliards, trois analystes ont prédit un échec. Ils s'étaient tous trompés sur la même chose."
269 
270**Use when**: business piece, profile, analytical essay. **Avoid**: name-dropping without payoff. The action must be specific and relevant.
271 
272### 16. Time Anchor
273 
274Lead with a specific date, hour, or moment.
275 
276- EN: "October 2005. Three journalists set up a blog in an apartment of the cité Blanqui, in Bondy."
277- EN: "In 2022, the cost of writing a competent article dropped to zero. Most writers haven't noticed."
278- EN: "On a Tuesday morning in March 1976, a 21-year-old dropout sold his Volkswagen Bus for 1,500 dollars."
279- FR: "Octobre 2005, Bondy. Trois journalistes installent un blog dans un appartement de la cité Blanqui."
280 
281**Use when**: reported piece, retrospective, "why now" framing. **Avoid**: vague time anchors ("recently", "these past few years"). Use a specific date or cut the time framing.
282 
283### 17. Conditional ("If you... then this")
284 
285Self-segment the reader. Pre-target the curiosity.
286 
287- EN: "If you write for a living, you've probably been taught to start with context. Don't."
288- EN: "If you've ever read a blog post and forgotten what it said within the hour, this article is the diagnostic."
289- EN: "If you're not saying 'HELL YEAH!' about something, say no." (Sivers)
290- FR: "Si vos articles sont lus à 80% par vos collègues et à 8% par vos prospects, le problème n'est pas le contenu. C'est l'accroche."
291 
292**Use when**: tutorial, advice piece, segmented audience. **Avoid**: conditions too broad ("If you've ever felt stuck..."). Segments nobody.
293 
294### 18. Open Loop
295 
296Start something, withhold the resolution.
297 
298- EN: Talese's Sinatra waiting for him to say something. He never says.
299- EN: "He pressed Send and waited. Forty-seven seconds later, the company was worth 4 billion dollars less."
300- EN: "Now here's where it gets really interesting..." (Sugarman, transition phrase, also valid as opener)
301- FR: "J'ai été contacté par un éditeur la semaine dernière. Ce qu'il m'a demandé m'a fait reconsidérer 15 ans de pratique."
302 
303**Use when**: longform, pieces where the journey matters as much as the answer. **Avoid**: unresolved loops. Creates disproportionate betrayal when the article ends without paying off.
304 
305---
306 
307## Anti-patterns (never propose any of these)
308 
309Cliché openers that immediately disqualify the writer:
310 
311- "In today's fast-paced world..." / "À l'heure du tout-numérique" / "À l'ère de l'IA" / "Dans un monde où..."
312- "Have you ever wondered...?" / "Vous êtes-vous déjà demandé...?"
313- Dictionary opener played straight ("Productivity, defined as...")
314- "In this article, I'll discuss..." / "Dans cet article, nous allons voir..."
315- Generic stats without source ("90% of people...", "Les études montrent...")
316- Misattributed Einstein / Seneca / Confucius / Bouddha quotes
317- "I'm not an expert, but..." / "Je ne suis pas spécialiste mais..."
318- Three rhetorical questions in a row
319- "Imagine waking up..." without a specific scene
320- "Hot take:", "Unpopular opinion:", "Voici la vérité que personne ne veut entendre..."
321- "At [Company], we believe..." / "Chez [Entreprise], nous pensons..."
322- "Recently,..." / "Récemment,..." without a specific date
323- "You're not alone."
324 
325Current AI tells (refresh yearly):
326 
327- "It's not just X, it's Y" (the formula construction)
328- "Picture this:", "Imagine a world where...", "What if I told you..."
329- "Whether you're a seasoned X or a curious newcomer..."
330- "In the realm of...", "Navigating the landscape of..."
331- "Unlock the power of...", "Dive into...", "Buckle up,", "Let's dive in"
332- "Crucially,", "Notably,", "Importantly,", "Essentially," as sentence openers
333- French AI tells: "Dans un monde en constante évolution", "Plongez dans...", "Découvrez comment...", "Par ailleurs,...", "Notamment,...", "Il est crucial de..."
334 
335Run every candidate through this list before presenting. If a candidate matches, rewrite.
336 
337For the extended anti-pattern list, see `references/anti-patterns.md`.
338 
339---
340 
341## Language handling
342 
343**If the audience is French**: write in French, applying the _attaque journalistique_ register.
344 
345- Concrete scene-setting, restrained tone, dated anchors, formal "vous" or restrained tutoiement.
346- Do not translate American hype tropes literally — "You'll never believe..." becomes "Vous n'allez pas en croire vos yeux", which reads as scam in French.
347- French marketing-skepticism baseline is higher than English; high promises trigger _réactance_ faster.
348 
349**If English**: default to direct-response register for marketing or tutorial content, longform register for essays and reported pieces.
350 
351**If bilingual**: produce hooks in both languages, label clearly.
352 
353For deeper register guidance, see `references/anglophone-vs-francophone.md`.
354 
355---
356 
357## Post Titles
358 
359A **title** is what the reader sees before clicking. A **hook** is what they read after. Both earn attention through different mechanisms: the title competes for clicks in a feed or search result; the hook earns continued reading after the click.
360 
361### The core mechanic: calibrated curiosity
362 
363A title must open a gap without closing it — but the gap must feel real, not manufactured. Research on 8,977 A/B experiments (Upworthy, _Scientific Reports_ 2024) found a curvilinear relationship: too vague produces confusion (no foothold for curiosity); too specific removes motivation to click. The sweet spot: name the stakes, withhold the resolution.
364 
365**The craft test.** Does the title open a gap the reader cares about, and does the article genuinely close it? If yes, that's craft. If the content doesn't deliver what the title implied, that's clickbait — it destroys trust for future clicks.
366 
367### Core formulas
368 
369**Curiosity / Gap**
370 
371- `The [Adjective] Truth About [Topic]` — "The Counterintuitive Truth About Go Generics"
372- `What [Group] Won't Tell You About [Topic]`
373- `The Real Reason [Phenomenon]` — "The Real Reason Most Content Gets Zero Shares"
374- `[Number] Things Every [Audience] Gets Wrong About [Topic]`
375 
376**Contrarian / Negative** (negative superlatives: +63% CTR vs. positive — Outbrain, 65k titles)
377 
378- `Stop [Doing X]. Here's Why.` / `Why [Common Belief] Is Wrong`
379- `[Number] [Myths/Mistakes] That Are Killing Your [Result]`
380 
381**Specificity / Data**
382 
383- `I Analyzed [Number] [Things] — Here's What I Found`
384- `[Number]% of [Group] Does This Wrong`
385- Brackets signal format honestly and add +38% CTR: `How I Cut Build Time by 60% [Benchmark]`
386 
387**List / Number** (numbers: +36% CTR — Conductor; odd numbers: +20% CTR — CMI)
388 
389- `[Number] [Adjective] Ways to [Goal]` / `[Number] Mistakes to Avoid When [Task]`
390 
391**How-To** (3× more B2B shares than other formats — BuzzSumo, 10M LinkedIn articles)
392 
393- `How to [Task] Without [Painful Constraint]` / `How to [Task] Even If [Limiting Belief]`
394 
395### The "putaclic léger" zone
396 
397Slightly clickbait but honest — maximum tension with a real promise:
398 
399- Replace "won't believe" → "surprised to learn": same curiosity, honest register
400- Add specificity: "I saved €500/month" beats "I saved money"
401- Add a constraint: "without quitting your job" creates the gap
402- Use "the real reason" or "what nobody tells you" — they signal a non-consensus view you must substantiate
403- Add a bracket `[Étude]`, `[Template]`, `[Benchmark]` to signal payoff type
404 
405**FR — putaclic carries stronger pejorative weight.** Apply the **70/30 rule**: 70% information, 30% mystery.
406 
407- Tension and contradiction work; faux drama ("J'arrête tout 😱") destroys credibility immediately in French professional contexts.
408- Canonical FR structure: "Tout le monde vous dit de faire A. Voici pourquoi je fais B."
409- Formulas saturated on LinkedIn FR in 2025+: "J'ai fait une erreur, voici ce que j'ai appris", "J'arrête [plateforme]".
410 
411### Platform constraints
412 
413| Platform | Max display | Key rule |
414| --- | --- | --- |
415| Blog / SEO | 50–60 chars | Front-load keyword. Power words reduce CTR by ~14% in search. |
416| LinkedIn article | 150 chars hard | Under 100 for clean display. |
417| LinkedIn feed | 120–140 chars | Opening line = the title. Engineer a "see more" click. |
418| Newsletter subject | 30–50 chars | First 30 chars carry the signal. Avoid "Newsletter" (−18.7% opens). |
419| X / Twitter | ≤200 chars | First tweet = the title. Must stand alone. |
420 
421### Anti-patterns for titles
422 
423- Generic superlatives without specificity: "The Ultimate Guide to X" — no gap
424- "You won't believe..." / "Vous n'allez pas y croire..." — overused, signals hype
425- Power words (Secret, Amazing, Ultimate) in SEO titles — signal hype, lower CTR
426- Titles that give away the full answer — if the title answers the question, there is no reason to click
427- Recycling saturated fingerprints: "I analyzed X things, here's what I found" — effective 2022–2023, saturating 2025–2026
428 
429### Behavior for title requests
430 
4311. Confirm topic, audience, language, platform
4322. Propose **3–5 titles** across distinct formulas — not three variants of the same type
4333. Include at minimum: one curiosity/gap, one contrarian or data, one list or how-to
4344. Use the same output format as hooks: numbered options, wait for the pick
4355. After the pick, note what the title commits the article's opening to
436 
437For the full 58-formula catalog (EN + FR) with data citations, see `references/title-formulas.md`.
438 
439---
440 
441## Reference files (load only when needed)
442 
443- `references/anti-patterns.md`: extended cliché and AI-tell list.
444- `references/anglophone-vs-francophone.md`: register conventions, what does not translate.
445- `references/formulas.md`: 30 reusable templates (EN + FR) for quick template-based hooks.
446- `references/title-formulas.md`: 58-formula post title catalog (EN + FR), platform constraints table, data summary.
447 
448The catalog above is sufficient for most invocations. Load references only when the user asks for templates, deeper register guidance, or to sanity-check anti-patterns.
449 
450---
451 
452## Integration with other ghostwriting skills
453 
454If invoked from inside another skill's workflow (e.g., `technical-article-writer` reaches the hook step), produce options, ask, wait. Return the chosen hook to the parent skill for the rest of the article.
455 
456If the user has already drafted an opening and asks for "a better one", treat that draft as **Option 0** (their current version) and propose 3 alternatives across different hooks. Do not silently discard their version.
457 
458---
459 
460## Worked example
461 
462User: "I'm writing a Substack piece on why most Go developers misuse generics. About 1500 words, intermediate Go devs, English."
463 
464Correct skill response:
465 
466```
467## Hook options for: "Why Most Go Developers Misuse Generics"
468 
469**Option 1: Contrarian** (prediction-break)
470A. Most articles on Go generics explain when to use them. This one explains when to delete them.
471B. Generics were the most requested Go feature for a decade. Three years in, the people who pushed hardest for them are the ones telling you to stop using them.
472 
473**Option 2: Concrete detail** (sensory + specific)
474A. samber/lo ships 87 generic helpers. Six of them account for 94 percent of the binary-size complaints. The other 81 are fine.
475B. A function called `Map[T, U any]` looks innocent. Compile a project that imports it 40 times and your build time triples. Here is why.
476 
477**Option 3: Direct problem (PAS)** (reader-direct)
478A. Your Go code compiles slower since you adopted generics. The cause is not what the linter is telling you.
479B. If your team adopted generics last year and your build times doubled, you are not alone. The diagnosis is more boring than the fix.
480 
481Which? Reply with letter combination (e.g., "1B") or "more" for different techniques.
482```
483 
484Then wait for the pick. Do not write the rest of the article until the user has chosen.
485 

Discussion

Alternatives

Also in Landing page copySee all 403 in Marketing →