
headline-generator
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.
- Installs
- 780
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/elvisun/newsjack --skill headline-generator- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads headline-generator automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
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.
FAQ
What does the headline-generator skill do?
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.
How do I install headline-generator?
Run npx skills add https://github.com/elvisun/newsjack --skill headline-generator in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/headline-generator/ (personal) or .claude/skills/headline-generator/ (project).
Which AI agents can use headline-generator?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is headline-generator safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains headline-generator?
It is published by elvisun in elvisun/newsjack. It has 780 recorded installs.
More from elvisun/newsjack
fact-check
elvisun/newsjack
Extract factual claims from PR copy, verify each claim independently, attach concrete citations, and warn when certainty is low. Runs each claim through proven newsroom verification methods (lateral reading, source-tier climbing, provenance pillars, triangulation, calibrated rating) and puts the burden of proof on the speaker. Use before a pitch, press release, reactive comment, DM, or other journalist-facing draft is trusted or sent.
news-search
elvisun/newsjack
Search current news for a topic, company, competitor, or hook and return dated, attributed articles. Uses the newsjack CLI and Medialyst REST API when available, tries direct Medialyst MCP if the CLI is missing, and falls back to host web/browser search with explicit caveats only when neither cloud path is available.
angle-generator
elvisun/newsjack
Turn a company update into 3-7 structurally distinct, journalist-shaped story angles. Runs the fact through proven newsroom lenses (perspective, abstraction, news values, data, contrarian, news peg) and refuses rephrasings, invented facts, named-journalist guesses, and AI-marketing slop.
voice-extractor
elvisun/newsjack
Capture a user's real writing voice from 5-20 prior samples, store a local voice.yaml fingerprint, and enforce it on newsjack drafts so AI tells disappear. Measures voice with named stylometry lenses (Burrows's Delta function-word vector, MATTR lexical diversity, sentence-length burstiness, Biber Dimension-1 register, opener-POS profile, punctuation rates) and gates drafts against the fingerprint as bands, not vibes.
crisis-holding
elvisun/newsjack
Draft crisis holding statements, journalist Q&A posture, and what-not-to-say guidance from confirmed incident facts, with a hard legal-counsel gate. Builds each statement through proven crisis-comms frameworks (holding-statement anatomy, SCCT, CAP order, the legitimate non-answer, bridge/flag/block).
newsworthiness-check
elvisun/newsjack
Score whether a news event is worth newsjacking, or whether a user's pitch idea is actually newsworthy to journalists. Uses calibrated anchors, hard anti-inflation rules, standing checks, timing windows, and brand-safety kill switches.
Popular media & creative skills
hyperframes
heygen-com/hyperframes
Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
media-use
heygen-com/hyperframes
Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
hyperframes-registry
heygen-com/hyperframes
About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.
hyperframes-creative
heygen-com/hyperframes
Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.
ai-video-generation
101-skills/superpowers
Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse
ai-image-generation
101-skills/superpowers
Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image