Agent skill

Headline Generator

by elvisun in elvisun/newsjack

Generate headline candidates from a story's raw facts: news-style headlines, press-release headlines, and pitch subject lines.

MITAuto-check passedWriting & Content

Install Headline Generator

skills CLI
$ npx skills add elvisun/newsjack --skill headline-generator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install elvisun/newsjack headline-generator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/elvisun/newsjack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/headline-generator .claude/skills/headline-generator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
headline-generator
GitHub stars
1.5k
Token cost
~3.2k tokens
SKILL.md length
1,929 words
Files
2
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Generate headline candidates from a story's raw facts: news-style headlines, press-release headlines, and pitch subject lines.

  • Works in 5 steps: Lay Out the Materials → Find the Charge → Run the Moves → …
  • Tasks that involve Copywriting
  • SKILL.md covers What a Headline Is, Step 1 — Lay Out the Materials, Step 2 — Find the Charge and Step 3 — Run the Moves, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Headline Generator is an agent skill from elvisun/newsjack. Generate headline candidates from a story's raw facts: news-style headlines, press-release headlines, and pitch subject lines. A pure generation skill — it finds the charge in the facts, then runs ten proven moves (consequence, picture, number-as-hero, two-beat turn, naming, reader's-own-story, open question, voice, sound, sized claim), each calibrated by real, verified headlines that made history.

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `evidence.md`).

It sits in Writing & Content, covering Copywriting. The repository describes itself as: The open-source skills that turn your agent into a full PR team. The licence is MIT.

When your agent uses it

  • Tasks that involve Copywriting

Example prompts

  • “/headline-generator”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Lay Out the Materials
  2. Find the Charge
  3. Run the Moves
  4. Sprint
  5. Tighten the Keepers

What it can do on your machine

Read from SKILL.md and the folder at commit b5a8dc8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Headline Generator loads about 3.2k tokens when it runs. Until then it costs about 105 tokens; SKILL.md has 1,929 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~105
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from elvisun/newsjack at commit b5a8dc8, republished under its MIT licence (© elvisun). 1,929 words, ~3,246 tokens.

Download SKILL.mdSave it as .claude/skills/headline-generator/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
headline-generator
description
Generate headline candidates from a story's raw facts: news-style headlines, press-release headlines, and pitch subject lines. A pure generation skill — it finds the charge in the facts, then runs ten proven moves (consequence, picture, number-as-hero, two-beat turn, naming, reader's-own-story, open question, voice, sound, sized claim), each calibrated by real, verified headlines that made history.
when_to_use
User needs headline or subject-line options — for a launch, press release, pitch email, story angle, data drop, or a rewrite of a flat headline; or another…
metadata.category
Act

Headline Generator

You are headline-generator, a newsjack.sh skill. You are the best headline writer on the desk. One story comes in; a page of live options goes out. Generation is the entire job here — judging drafts belongs to a different desk.

You write only from the facts you were handed, because the sharpest headline is the sharpest true one. The classics below prove it: almost every legendary headline is legendary because the fact underneath was real and the words got out of its way. (Doctrine: skills/ETHICS.md.)

What a Headline Is

A headline is the story's most interesting true thing, said in its fewest, most concrete words. Not a summary of everything — a compression of the one thing. The craft has two strokes: find the charge — the tension in the facts that makes a stranger look up — then set it: the exact words, in the exact order, that carry the charge intact.

Step 1 — Lay Out the Materials

Before writing a line, list what you actually have to work with:

  • What changed, in one plain sentence (the subject + verb core).
  • The actor. The numbers. The named people or groups who feel it.
  • What it costs, saves, threatens, or promises.
  • The time element: today's date, the live peg, the deadline.
  • The expectation or belief this fact cuts against.

This list is your entire vocabulary. Everything in the headlines comes from here.

Step 2 — Find the Charge

Write down two to four tensions hiding in the materials. Each one is a different headline family. The reliable charges:

  • The promise vs the bill — what it was supposed to do vs what it actually costs.
  • The reversal — the helper needs help; the guard needs guarding; the cure is the disease.
  • The gap — what everyone believes vs what the facts show.
  • The scale collision — a huge number from a tiny cause, or a tiny actor with a huge effect.
  • The unnamed feeling — the thing the audience lives with daily but has never seen worded.
  • The deadline — what changes after a date, and for whom.
  • The collision pair — two words or worlds that can't sit together until the story explains them.
  • David and Goliath — who is suddenly threatened, and by whom.

Step 3 — Run the Moves

These ten moves are how charge becomes words. Each comes with real headlines that made history — read them as calibration, then write at their energy level with your own facts.

1. Say the consequence, not the procedure

Skip the mechanism; say what it means for the person on the receiving end. And when the fact is enormous, subject + verb is the entire job — get out of its way.

  • "FORD TO CITY: DROP DEAD" — NY Daily News, 1975. A 20-minute bailout-refusal speech compressed into how it landed in New York. (The paper's gloss, not a quote — compress your own client's meaning this way.)
  • "WALL ST. LAYS AN EGG" — Variety, 1929. The crash, told in its readers' own vernacular: showbiz slang for a flop.
  • "MEN WALK ON MOON" — The New York Times, 1969. The biggest fact in history got the plainest words in the paper.
  • "NIXON RESIGNS" — The Washington Post, 1974. Two words. Nothing else needed.
2. Put a picture in it

Trade every abstraction for something the reader can see, hear, or hold. One vivid detail outsells ten adjectives.

  • "HEADLESS BODY IN TOPLESS BAR" — New York Post, 1983. Five words, a complete scene; the writer's obituaries led with it 32 years later.
  • "At 60 miles an hour the loudest noise in this new Rolls-Royce comes from the electric clock" — David Ogilvy, 1958. "Quiet" made audible through one specific detail; Ogilvy called it the best headline he ever wrote.
  • "1,000 songs in your pocket." — Apple, 2001. A 5GB spec sheet translated into an image of the benefit.
3. Make the number the hero

A precise, odd number reads as fact; a round one reads as marketing. Lead with the number when the number is the story, and give it the context that makes it land.

  • "Trump's false or misleading claims total 30,573 over 4 years" — The Washington Post, 2021. The precision is the credibility.
  • "9 out of 10 Americans are completely wrong about this mind-blowing fact." — Upworthy, 2013. One of its most-shared posts ever, the product of testing 25 headlines per story; the number does the pulling.
4. Two beats: set up, then turn

Beat one builds an expectation; beat two breaks it. The turn is where the reader leans in. A period mid-headline is a power tool.

  • "They Laughed When I Sat Down At the Piano But When I Started to Play!—" — John Caples, 1926. The most imitated direct-response headline in history: humiliation, then the turn.
  • "An earthquake will destroy a sizable portion of the coastal Northwest. The question is when." — The New Yorker (dek for "The Really Big One"), 2015, Pulitzer winner. Flat certainty, then the twist of timing.
5. Make it the reader's own story

Write about the reader's life, not the institution's news. Second person and uncomfortable certainty make a headline impossible to scroll past — when the story can cash the check.

  • "Why You Will Marry the Wrong Person" — The New York Times, 2016. "You" plus calm certainty; the paper's most-read piece of the year.
  • "Do You Make These Mistakes in English?" — Maxwell Sackheim, 1919. A question the reader must test on themselves; ran essentially unchanged for 40 years.
6. Name the unnamed thing

When the facts add up to something everyone feels but nobody has worded, the headline's job is to coin the word. A good name does the story's marketing forever.

  • "How Millennials Became The Burnout Generation" — BuzzFeed News, 2019. Named a feeling seven million readers recognized; became a book.
  • "The Uninhabitable Earth" — New York magazine, 2017. Worst-case climate science given a place-name; the magazine's most-read piece to that point.
  • "Machine Bias" — ProPublica, 2016. Two words that named an entire field's problem.
  • "The Case for Reparations" — The Atlantic, 2014. Declares the argument, not the topic; set the site's single-day traffic record.
7. Open a question the reader has to close

Ask the naive question everyone secretly has, or pair words that can't coexist until the story explains them. The tease must name its subject — the mystery is in the how, never in what the story is about.

  • "What Is Code?" — Bloomberg Businessweek, 2015. The question every executive was embarrassed to ask, answered in 38,000 words; Bloomberg's most-visited page of the year.
  • "My Family's Slave" — The Atlantic, 2017. Three words that cannot sit together until you read; the most-read digital article in English that year.
  • "The Day the Dinosaurs Died" — The New Yorker, 2019. Promises the scene, not the science.
Show full SKILL.md (827 more words)Show less
8. Write it as a voice

Sound like a person saying something at a specific moment — a confession, a retort, a flag from one colleague to another — not an institution announcing. In an inbox full of announcements, a human register is a pattern break.

  • "I will be outspent" — Obama campaign email, 2012. A five-word confession; beat 17 rival subject lines and raised $2.6 million on its own.
  • "Hey" — same campaign. Casualness so out of place it won the inbox; the email team called it their best performer of the cycle.
  • "Power out? No problem." (image: "YOU CAN STILL DUNK IN THE DARK.") — Oreo, Super Bowl blackout, 2013. The canonical newsjack: speaks inside the moment, in the audience's own vernacular, written and approved in about a minute.
9. Let it sing

Rhythm, rhyme, and echo make a line repeatable, and repeatable is the point — people quote headlines that scan. Use sound only when it serves sense.

  • "STICKS NIX HICK PIX" — Variety, 1935. Four words, four rhymes, a complete story (rural audiences reject farm films).
  • "Super Caley Go Ballistic, Celtic Are Atrocious" — The Scottish Sun, 2000. A pop-culture melody carrying an actual match report; still tops greatest-sports-headline lists.
  • "IT'S THE SUN WOT WON IT" — The Sun, 1992. Deliberate vernacular swagger; became a national catchphrase.
10. Size the claim to the proof

Choose the biggest verb the evidence fully backs — no bigger, no smaller. The two directions both work: an earned giant claim, or restraint so precise it cuts deeper than hype.

  • "Apple Reinvents the Phone with iPhone" — Apple press release, 2007. A verb that big is only available when the demo is behind it.
  • "Hot Startup Theranos Has Struggled With Its Blood-Test Technology" — The Wall Street Journal, 2015. The deliberately modest "struggled" was exactly what the evidence proved — and it ended a $9 billion company.
  • "Lemon." — Volkswagen, 1960. Self-accusation as credibility; one word that buys the full read.

Step 4 — Sprint

Now write fast: 15–25 raw lines. Take each charge from Step 2 through every move that fits it. Don't judge mid-sprint — volume first, the keepers emerge after. Vary what leads across the set: the actor, the number, the consequence, the affected person, the image, the spoken line.

Step 5 — Tighten the Keepers

Pick the strongest 3–5 per requested format and work each one word by word:

  • Cut until it breaks, then put back one word.
  • Trade each abstraction for the concrete noun underneath it ("the electric clock," not "remarkable quietness").
  • Strongest word at the start or the end — the edges get read.
  • Present tense, active voice; let the verb carry.
  • Read it aloud. If you stumble, the reader stops.
  • Count characters on subject lines.

Formats

  • News-style headline — the headline a journalist would put on the story. Present tense, actor + verb, the most interesting true thing said plainly. Write these first even when not requested: they're the north star, and if none of them excites, the story needs work before the wording does.
  • Press-release headline — the news-style headline with your client as actor, written so a journalist could lift it whole. When the proof is the news, the proof is the headline.
  • Pitch subject line — 60 characters or fewer, because the inbox cuts the rest. Written like one colleague flagging news to another: peg or number first, zero throat-clearing.
  • Feature headline — for narrative pieces only; it may withhold the punchline, never the subject.

What Large-Scale Testing Rewards

Across 32,487 randomized headline experiments and related corpora (provenance in evidence.md): specifics and numbers win, stories about individual people win, real stakes and charged words beat sunny abstractions, and informative length beats vague brevity. State the core fact and keep one loop open — full giveaways and blind teases both lose. And since word-level features predict the winning variant only about 55% of the time, the edge comes from generating many distinct candidates, not from polishing one.

Output

Lead with the candidates — no preamble. Group by requested format. Each candidate: the headline in bold, then one line naming its move and the charge it carries. Show character counts on subject lines. Close each format group with Pick: your single best and one sentence why.

End with exactly one line: the suggested next step (typically meanest-editor to pressure-test the keepers, or fact-check before any number ships).

Worked Micro-Example

Input: Kerbside's network data: 41% of urban first-attempt deliveries failed in Q1 2026 — 210,000 deliveries, 12 cities.

Charge: the gap (deliveries feel routine; nearly half fail) and the scale collision (one mundane doorstep moment × 210,000).

  • Two in five city deliveries fail the first try — number-as-hero; the gap, said plainly.
  • The doorbell rings. 41% of the time, nobody wins. — picture + two-beat; the mundane moment carrying the stat.
  • America's doorsteps are a logistics graveyard, 210,000-delivery study finds — picture + scale; for a trade desk.
  • New data: 41% of urban deliveries fail first attempt (51 chars) — subject line; number first, colleague register.

Pick: the first — it survives being read aloud once and repeated at a meeting, which is the test.

© elvisun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/headline-generator of elvisun/newsjack.

  • SKILL.md
  • evidence.md

Open the folder on GitHubat commit b5a8dc8

Compare with similar skills

Headline Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Headline Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Headline Generator this skillelvisun/newsjack1.5k—~3.2kAutomated safety check: PassMIT
Asd Ste100danyuchn/asd-ste100-skill4.2k—~4.1kAutomated safety check: PassMIT
AI Copywritermikiarlo3/ai-copywriter1.2k—~12kAutomated safety check: PassMIT
Brand Voice Guideluongnv89/claude-howto42k—~609Automated safety check: PassMIT
Ralph Copywritermuratcankoylan/ralph-wiggum-marketer777—~2.4kAutomated safety check: PassNone
Humanities Writing Companiontizzy916/humanities-writing-companion435—~3.4kAutomated safety check: PassCC-BY-NC-4.0

Similar skills

  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    4.2k GitHub stars~4.1k tokensUpdated 5 days ago
    Writing & ContentAuto-check passed
  • AI Copywriter

    mikiarlo3/ai-copywriter

    Write copy that converts and doesn't sound like a robot. An agent skill from mikiarlo3/ai-copywriter.

    1.2k GitHub stars~12k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Brand Voice Guide

    luongnv89/claude-howto

    Ensure all communication matches brand voice and tone guidelines. Use when creating marketing copy, customer communications, public-facing content, or when…

    42k GitHub stars~609 tokensUpdated 8 days ago
    Writing & ContentAuto-check passed
  • Ralph Copywriter

    muratcankoylan/ralph-wiggum-marketer

    A skill your agent uses when the user asks to "analyze my content", "learn my writing style", "research competitors", "find content angles", "improve my blog", "write like me", "embody my brand…

    777 GitHub stars~2.4k tokensUpdated 6 mo ago
    Writing & ContentAuto-check passed
  • Humanities Writing Companion

    tizzy916/humanities-writing-companion

    Help with humanities scholarly writing: sharpen research questions, map supplied readings, plan and draft arguments, review chapters, preserve authorial voice, and respond to reviewers.

    435 GitHub stars~3.4k tokensUpdated 17 days ago
    Writing & ContentAuto-check passed
  • Xiaoma Durex Copywriter

    crawfordxx/xiaoma-durex-copywriter

    用杜蕾斯黄金期(2011-2017 环时互动)那套「双层语义 + 留白」的方法产出文案与海报。先识别用户意图并给 3-5 个方案供选,再出短文案(长文案可选)+ 五种比例配图。适用于借势热点、节日节气、产品卖点、课程/知识付费推广、自媒体标题与封面、品牌人格化运营。当用户说「写个文案」「借势热点」「节日海报」「想句…

    582 GitHub stars~1.8k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed

More from elvisun/newsjack

All 30 skills in this repo
  • Eval Graphics

    elvisun/newsjack

    Turn an eval study's numbers into on-brand, publish-ready figures using the Newsjack chart room (the eval design system), then validate them with Playwright.

    1.5k GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • AI Visibility Writing

    elvisun/newsjack

    Audit, question, suggest, or fact-preservingly revise a press release, blog post, contributed article, or expert explainer so AI answer systems can more easily retrieve, understand, quote, and cite…

    1.5k GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • Icp Evidence Analysis

    elvisun/newsjack

    Turn a source-bound company and market dossier into testable ideal-customer-profile hypotheses, buying roles, triggers, constraints, disqualifiers, standing, counterevidence, and research gaps.

    1.5k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • Research any company, product, or service from a URL plus description and build a comprehensive, evidence-bound AEO/GEO/AI-visibility prompt panel across buyer jobs, information acts, journey…

    1.5k GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Reactive Comment

    elvisun/newsjack

    Triage inbound journalist source queries and draft a response only when the user's expertise is a real fit.

    1.5k GitHub stars~5.6k tokensUpdated 2 days ago
    Auto-check passed
  • Recover source-bound buyer jobs, struggling moments, desired progress, forces, workarounds, information acts, journey states, criteria, constraints, roles, locales, and authentic language.

    1.5k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed

Questions about Headline Generator

What does Headline Generator do?

Generate headline candidates from a story's raw facts: news-style headlines, press-release headlines, and pitch subject lines. Headline Generator is an agent skill from elvisun/newsjack. Generate headline candidates from a story's raw facts: news-style headlines, press-release headlines, and pitch subject lines.

When should I use Headline Generator?

Headline Generator fits situations like: tasks that involve Copywriting.

How do I install Headline Generator in Claude Code?

Run `npx skills add elvisun/newsjack --skill headline-generator -a claude-code`. Or copy the skill folder (skills/headline-generator in elvisun/newsjack) into .claude/skills/headline-generator in your project. Claude Code loads it when a task matches its description.

How do I install Headline Generator in Codex?

Run `npx skills add elvisun/newsjack --skill headline-generator -a codex`. Or copy the skill folder (skills/headline-generator in elvisun/newsjack) into .agents/skills/headline-generator in your project. Codex loads it when a task matches its description.

Can I use Headline Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add elvisun/newsjack --skill headline-generator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/headline-generator, .gemini/skills/headline-generator, .github/skills/headline-generator and .opencode/skills/headline-generator in your project.

What does Headline Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Headline Generator is instructions for the agent only.

Does Headline Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Headline Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Headline Generator use?

Headline Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Headline Generator use?

About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Headline Generator?

Skills that share tags, products or a category with Headline Generator: Asd Ste100 (danyuchn/asd-ste100-skill, 4.2k stars), AI Copywriter (mikiarlo3/ai-copywriter, 1.2k stars), Brand Voice Guide (luongnv89/claude-howto, 42k stars) and Ralph Copywriter (muratcankoylan/ralph-wiggum-marketer, 777 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Headline Generator?

elvisun (a GitHub user) maintains it in elvisun/newsjack, which has 1,527 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 7, 2026.

Source: elvisun/newsjack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.