copywriting-hooks

The first line of an article decides whether anyone reads the second one; this writes that line, and the title above it, in English or French.

WHEN TO USE

SCOPE

USE FOR

Get several different opening hooks for a blog post, essay, or newsletter to choose from.
Write a post title tuned to a curiosity sweet spot instead of vague or fully-revealing.
Fix a flat opening paragraph by testing it against five distinct hook techniques.
Get hook options in French with the right register instead of translated English clichés.
Screen a draft opening for the cliché phrases and AI writing tells that flag it as generic.

NOT FOR

Writing social posts, taglines, ad copy, email subject lines, or SEO meta descriptions.
Designing the call-to-action at the end of an article, which a separate skill covers.

This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.

In this document (11)

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:

Open a gap. Pose something incomplete that the reader needs to close. Curiosity gap, question, open loop.
Break a prediction. State something that violates the reader's prior. Contrarian, definition reversal, surprising statistic.
Drop into a scene. Load sensory or specific detail that builds a vivid frame. In medias res, concrete detail, time anchor.
Promise a payoff. Name an outcome the reader wants. Benefit, "if you... then this", direct problem.
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:

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.
Pick 3 to 4 hooks from the catalog below that are genuinely different. Different levers, not three flavors of contrarian.
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.
Present using the Output format below.
Ask through the question tool. The choice is a small fixed set, which is what that tool is for.
Wait for the user's pick. Do not pick for them.
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

Confirm topic, audience, language, platform
Propose 3–5 titles across distinct formulas — not three variants of the same type
Include at minimum: one curiosity/gap, one contrarian or data, one list or how-to
Use the same output format as hooks: numbered options, wait for the pick
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.

This skill ships inside the Samber Marketing & Engineering Skills plugin.

Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.

Install checklist

Check selected tools if a picker appears; Claude Code may be unchecked under Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.
Without a tool picker, check Installing to: for your intended tool. Stop if it names a different tool.
If asked, choose Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.
Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.

Skills CLI 1.7.2 sends install data to skills.sh by default, including the source, skill names, target tools and file details; GitHub sources are reported only when GitHub confirms the repository is public, while other remote sources can also be reported. Confirmed-public GitHub sources also trigger a security-audit request. Before installing, set the environment variable DO_NOT_TRACK=1 or DISABLE_TELEMETRY=1 to disable both.

npx skills add samber/cc-skills --skill "copywriting-hooks" --full-depth

After installing for Claude Code, open it in the installation project if you chose Project; Global makes the skill available across projects on this computer. Once Claude Code loads the skill, its description helps Claude decide when to use it.

If installation created a top-level skills folder that did not exist when your Claude Code session started, run /reload-skills in that session. Run it again after later changes in that folder.

What's inside

Files included with this skill.

View on GitHub

Same repository

chrome-extension
Build Chrome extensions with Manifest V3. Use this skill whenever the user mentions Chrome extension, browser extension, manifest.json, content script, service worker (in extension context), popup, side panel, chrome.runtime, chrome.tabs, chrome.storage, chrome.scripting, or any Chrome extension API. Also trigger when the user wants to inject scripts into web pages, communicate between page and background, bypass CSP from a content script, build an RPC layer over chrome messaging, or publish to the Chrome Web Store. Covers both new extension projects and adding features to existing ones. Do NOT use for CRXJS/Vite-based builds with HMR — use samber/cc-skills@crxjs instead.Read full description
conventional-git
Conventional Commits v1.0.0 branch naming, worktree naming, and commit message standards for GitHub and GitLab projects. Use when creating branches, naming worktrees, writing commits, generating commit messages, reviewing branch conventions, or setting up changelog automation. Apply when your project needs consistent git history, SemVer-driven releases, parseable changelog generation, or automatic issue closing. Trigger when the user asks how to name a worktree, create a git worktree, or organize worktrees alongside branches.Read full description
copywriting-cta
Designs end-of-article CTAs — copy, layout, placement, A/B test plan, accessibility — for blog posts, newsletters, and essays. Use whenever the user asks to write, review, or improve a CTA at the bottom of an article; mentions "end-of-post CTA", "call-to-action", "signup box", "newsletter CTA", "subscribe block", or "what should I put at the bottom"; or asks how to turn readers into subscribers, leads, customers, or paying supporters. Covers personal blogs, paid newsletters (Substack, beehiiv, Ghost), and brand content-marketing blogs. Do NOT use for opening hooks, ledes, or post titles — use samber/cc-skills@copywriting-hooks instead. Not for landing-page, ad, or email copy.Read full description
copywriting-prose-creator
Codifies how a person or brand writes — lexicon, syntax, rhythm, structure, signature moves — into a PROSE.md guide, independent of emotional tone. Builds from SOUL.md and TONE.md, ports a guide to another channel, or reverse-engineers prose patterns from a corpus. Trigger on PROSE.md, writing style guide, prose guide, house style, ghostwriter style, writing playbook, banned words, sentence-length targets, or multi-writer consistency in a content factory. Do NOT use for writing actual content — use samber/cc-skills@linkedin-ghostwriting or samber/cc-skills@technical-article-writer instead. Not for tone decisions (samber/cc-skills@copywriting-tone-of-voice-creator), hooks, or CTAs.Read full description
copywriting-tone-of-voice-creator
Builds a brand tone of voice guide (TONE.md) — voice attributes with do's/don'ts, NN/g positioning, tone modulation matrix, lexicon, channel rules — for downstream content skills to consume. Also ports an existing TONE.md to a new channel (blog → LinkedIn, web → Twitter/X, in-product UI). Covers B2B SaaS, B2C/D2C, NGO, public sector, consulting, industrial, product-led, personal, and volunteering brands. Apply when the user wants to define or refresh a brand voice, port it to a new channel, or set up a content factory. Not for writing individual posts, articles, emails, or UI strings — use the dedicated writing skills. Not for SOUL.md, PROSE.md (samber/cc-skills@copywriting-prose-creator), or DESIGN.md.Read full description
crxjs
CRXJS Chrome extension development — true HMR for popup, options, content scripts, side panels, manifest-driven builds, dynamic content script imports (?script, ?script&module), and defineManifest for type-safe manifests. Uses Vite as its build tool. Use when the user mentions CRXJS, crxjs, @crxjs/vite-plugin, 'extension with hot reload', 'HMR for chrome extension', or wants to set up a CRXJS-based Chrome extension project with any framework (React, Vue, Svelte, Solid, Vanilla). Also trigger when the user has an existing CRXJS project and wants to add features, fix HMR issues, or configure content scripts with CRXJS. For general Chrome extension architecture (messaging, CSP, storage, permissions) -> See samber/cc-skills@chrome-extension skill.Read full description