newsjack 0.1.9 → 0.1.10

package/COMMIT

@@ -1 +1 @@
-8c0ba44855450e68b4e8cc382b2e3ad3ecedc404
+8bbacfe9f5e21137561014b8e151004dbe7b9bd4

package/README.md

@@ -80,6 +80,14 @@ Or review the script before running it:
 curl -fsSL https://newsjack.sh
 ```
 
+No surprises: that's the exact, unminified [`install.sh`](install.sh) in this
+repo — `newsjack.sh` serves this file and every release bundles it unchanged, so
+what you read here is what runs. Read it before you pipe it to a shell.
+
+The routing is open too: [`apps/site/proxy.ts`](apps/site/proxy.ts) is the
+Next.js handler behind `newsjack.sh` — it rewrites installer user-agents
+(curl/wget) to `install.sh` and 308-redirects everyone else to this repo.
+
 The installer detects your agent runtime and installs the CLI-backed skills
 automatically.
 
@@ -92,17 +100,44 @@ newsjack install
 
 After install, agents and skills should call the CLI as `newsjack`.
 
-### Limited Mode: Claude.ai, ChatGPT, Claude Cowork
+### Windows
+
+No script, no git, no Node. One PowerShell line downloads the CLI and runs
+setup (requires v0.1.10 or later):
+
+```powershell
+[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iwr https://github.com/elvisun/newsjack/releases/latest/download/newsjack_windows_amd64.exe -OutFile newsjack.exe; Unblock-File newsjack.exe; .\newsjack.exe setup
+```
+
+The TLS line makes the download work on stock Windows PowerShell 5.1 (it's a
+no-op on PowerShell 7).
 
-Do not try to install the Newsjack CLI inside browser chat or restricted Cowork
-surfaces. Use the marketplace/upload/manual skill path instead.
+`newsjack setup` downloads the skills bundle, verifies its checksum, installs
+the CLI to `%USERPROFILE%\.newsjack\bin`, and walks you through the same
+guided setup as macOS/Linux — including installing Claude Code through its
+own native Windows installer if you don't have it yet. Updates are automatic,
+same as the curl install.
 
-Limited Mode keeps Newsjack's instruction layer for PR strategy, newsworthiness
-checks, pitch and angle generation, pitch critique, journalist-fit reasoning,
-fact-checking from pasted or searchable evidence, and best-effort manual news
-scans. It does not include saved monitors, scheduled runs, seen-state,
-deterministic freshness gates, full source ingestion, local artifacts, or
-cost-optimized multi-agent passes — set up a Full Mode harness for those.
+### Limited mode: Running on Claude.ai, ChatGPT, Claude Cowork
+
+Newsjack needs a local agent for Full Mode. On Claude.ai, ChatGPT, or Claude
+Cowork it automatically falls back to Limited Mode — no install, no CLI, no
+setup. Paste your startup URL or your news and you get a real PR operator on the
+spot.
+
+**Every skill still works.** PR strategy, newsworthiness scoring, story angles,
+pitch drafting and honest critique, journalist-fit reasoning, fit-checked media
+lists, reactive source-query responses, voice fingerprinting, and fact-checking
+against pasted or searchable evidence all run right in the chat — paste what
+you've got and go.
+
+The only things that change are the two always-on monitors — **newsjack
+monitoring** (watching your space for newsjacking opportunities) and **coverage
+monitoring** (Google Alerts-style keyword tracking). Without a local agent they
+can't keep saved profiles, run on a schedule, or remember what they've already
+flagged, so they fall back to best-effort, one-shot scans you trigger by hand.
+Want them running on autopilot? Set up Full Mode with the CLI harness and a local
+agent.
 
 For Claude.ai plugin-style setup:
 
@@ -139,7 +174,8 @@ skills installed to your detected runtime(s):
   newsjack-detector       find newsworthy moments before the wave breaks
   newsworthiness-check    score whether your news clears the bar
   angle-generator         turn one update into ten pitchable hooks
-  find-journalists      build small, fit-checked media lists
+  headline-generator      headlines and subject lines from raw story facts
+  find-journalists        build small, fit-checked media lists
   …and more
 ```
 
@@ -152,3 +188,7 @@ Npm-installed Newsjack uses npm for CLI updates:
 ```bash
 npm i -g newsjack@latest
 ```
+
+---
+
+Author: Elvis Sun — [LinkedIn](https://www.linkedin.com/in/elvissun) · [X](https://x.com/elvissun)

package/VERSION

@@ -1 +1 @@
-v0.1.9
+v0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newsjack",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Open-source agent skills and CLI for PR operators.",
   "license": "MIT",
   "homepage": "https://newsjack.sh",
@@ -14,6 +14,9 @@
   "bin": {
     "newsjack": "bin/newsjack"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "engines": {
     "node": ">=18"
   },
@@ -29,9 +32,9 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "newsjack-linux-arm64": "0.1.9",
-    "newsjack-linux-x64": "0.1.9",
-    "newsjack-darwin-arm64": "0.1.9",
-    "newsjack-darwin-x64": "0.1.9"
+    "newsjack-linux-arm64": "0.1.10",
+    "newsjack-linux-x64": "0.1.10",
+    "newsjack-darwin-arm64": "0.1.10",
+    "newsjack-darwin-x64": "0.1.10"
   }
 }

package/skills/headline-generator/SKILL.md

@@ -0,0 +1,168 @@
+---
+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 newsjack skill (angle-generator, newsjack-detector, meanest-editor) hands off a story that needs headline candidates."
+---
+
+# 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](./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.

package/skills/headline-generator/evidence.md

@@ -0,0 +1,58 @@
+# Headline Evidence Base
+
+Provenance for `headline-generator`: where the exemplar bank and the empirical priors come from. Compiled 2026-06-11 from two research passes — a multi-agent deep-research run on headline effectiveness (22 sources, 25 claims adversarially verified, 23 confirmed) and a verification sweep of every exemplar headline (exact printed wording, outlet, date, fame evidence).
+
+## Part 1 — Exemplar bank provenance
+
+Every headline in the skill's bank was verified against primary or strong secondary sources. Wording caveats matter: several classics are popularly misquoted.
+
+| Headline | Outlet / author, date | Fame evidence | Caveats |
+|---|---|---|---|
+| HEADLESS BODY IN TOPLESS BAR | NY Post (Vincent Musetto), Apr 15 1983 | Musetto's NYT/WaPo/NPR obituaries led with it; spawned a 1995 film | Often misquoted with "Found"/"a" — printed version has neither |
+| FORD TO CITY: DROP DEAD | NY Daily News, Oct 30 1975 | Own Wikipedia entry; Ford blamed it for losing New York State | Ford never said it — the paper's gloss on his bailout-refusal speech |
+| WALL ST. LAYS AN EGG | Variety, Oct 30 1929 | Library of Congress item; perennial greatest-headline lists | Printed "Wall St.", not "Wall Street" |
+| STICKS NIX HICK PIX | Variety, Jul 17 1935 | Variety's own most-famous headline; Oxford Reference entry | "STIX NIX HIX PIX" (Yankee Doodle Dandy) is a famous misquote |
+| MEN WALK ON MOON | NYT, Jul 21 1969 | Among the most reproduced front pages in history | Full deck: "ASTRONAUTS LAND ON PLAIN; COLLECT ROCKS, PLANT FLAG" |
+| NIXON RESIGNS | Washington Post, Aug 9 1974 | Among the most collected US front pages of the century | — |
+| Super Caley Go Ballistic, Celtic Are Atrocious | The Scottish Sun (Paul Hickson), Feb 9 2000 | Tops greatest-sports-headline lists; own Wikipedia article | Claimed 1960s Liverpool Echo precursor is apocryphal — never found in print |
+| IT'S THE SUN WOT WON IT | The Sun, Apr 11 1992 | British political catchphrase; cited at the Leveson Inquiry | Influence claim contested; the craft is undisputed |
+| "At 60 miles an hour the loudest noise in this new Rolls-Royce comes from the electric clock" | Ogilvy for Rolls-Royce, 1958 | Ogilvy called it his best; RR US sales reportedly +~50% in 1958 | No comma after "hour"; original ran in quote marks (it quotes The Motor's technical editor) |
+| They Laughed When I Sat Down At the Piano But When I Started to Play!— | John Caples, U.S. School of Music, 1926 | Most imitated direct-response headline in history | No published response stats — "legendarily successful," not a number |
+| Do You Make These Mistakes in English? | Maxwell Sackheim for Sherwin Cody, 1919 | Ran essentially unchanged ~40 years as an unbeaten control (Battistella, OUP 2009) | — |
+| Think small. / Lemon. | VW / DDB (Krone, Koenig), 1959 / 1960 | "Think Small" = Ad Age's #1 campaign of the 20th century | Two different years |
+| 1,000 songs in your pocket. | Apple, Oct 23 2001 | Gold-standard benefit positioning | The tagline, not the PR headline (that was "Apple Presents iPod") |
+| Apple Reinvents the Phone with iPhone | Apple press release, Jan 9 2007 | Still live on Apple's newsroom; stock exemplar of claim-led PR | The big verb was backed by the demo |
+| Hot Startup Theranos Has Struggled With Its Blood-Test Technology | WSJ (John Carreyrou), Oct 15 2015 | George Polk Award; ended Theranos; spawned *Bad Blood* | The deliberately modest verb is the lesson |
+| I will be outspent / Hey | Obama campaign emails, 2012 | "Outspent" beat 17 variants, raised ~$2.6M (Bloomberg Businessweek, Nov 2012); "Hey" called their best performer qualitatively | The $2.6M belongs to "I will be outspent" — widely misattributed to "Hey" |
+| Power out? No problem. / YOU CAN STILL DUNK IN THE DARK. | Oreo / 360i, Feb 3 2013 | 15,000+ retweets in hours; two Cannes Lions; founding real-time-marketing case | Tweet text vs image text split as shown |
+| 9 out of 10 Americans are completely wrong about this mind-blowing fact. | Upworthy (Adam Mordecai), Mar 2013 | #6 on Upworthy's own first-year most-shared list (1.57M views in ~a month); canonical product of its 25-headline testing process | Sentence case is Upworthy's rendering; "single most-shared ever" is not verifiable — don't claim it |
+| Why You Will Marry the Wrong Person | NYT (Alain de Botton), May 28 2016 | NYT's #1 most-read piece of 2016 | — |
+| The Really Big One (dek: "An earthquake will destroy a sizable portion of the coastal Northwest. The question is when.") | The New Yorker (Kathryn Schulz), Jul 2015 | 2016 Pulitzer for Feature Writing | Dek verified verbatim |
+| What Is Code? | Bloomberg Businessweek (Paul Ford), Jun 2015 | Most-visited Bloomberg.com page of 2015; National Magazine Award | — |
+| The Case for Reparations | The Atlantic (Ta-Nehisi Coates), May 2014 | Single-day traffic record for an Atlantic magazine article; Polk Award | — |
+| How Millennials Became The Burnout Generation | BuzzFeed News (Anne Helen Petersen), Jan 5 2019 | 7M+ readers; BuzzFeed News' most-read of 2019; became *Can't Even* | House style capitalizes "The" |
+| The Uninhabitable Earth | New York magazine (David Wallace-Wells), Jul 2017 | Most-read in the magazine's history *at the time* (later passed by the Fire and Fury excerpt) | Climate Feedback flagged accuracy issues in the piece — cite as headline craft only |
+| My Family's Slave | The Atlantic (Alex Tizon), May 16 2017 | Chartbeat's #1 most-read English-language digital article of 2017 (~58M engaged minutes) | — |
+| The Day the Dinosaurs Died | The New Yorker (Douglas Preston), Mar 2019 | #3 on The New Yorker's own top-25 stories of 2019 | Paleontologists contested the science framing — headline craft only |
+| Machine Bias (dek: "There's software used across the country to predict future criminals. And it's biased against blacks.") | ProPublica (Angwin et al.), May 23 2016 | 2017 Pulitzer finalist; the canonical algorithmic-bias citation | Dek verified verbatim |
+| Trump's false or misleading claims total 30,573 over 4 years | Washington Post (Glenn Kessler), Jan 24 2021 | Capstone of the Fact Checker database project | Headline uses numeral "4," not "four" |
+| Inside Amazon: Wrestling Big Ideas in a Bruising Workplace | NYT (Kantor & Streitfeld), Aug 15 2015 | Most-commented NYT story at the time; drew a public Bezos response | Reserve exemplar (not currently in the bank) |
+| Snow Fall: The Avalanche at Tunnel Creek | NYT (John Branch), Dec 20 2012 | 2013 Pulitzer + Peabody; "to snowfall" became newsroom shorthand | Reserve exemplar (not currently in the bank) |
+
+Deliberately excluded: "Dewey Defeats Truman" (wrong), "Gotcha" (tragedy), "Freddie Starr Ate My Hamster" (fabricated story), Bloomberg's "The Big Hack" (disputed reporting), "Egghead Weds Hourglass" (no primary source found).
+
+## Part 2 — Empirical priors (what large-scale testing shows)
+
+From the deep-research pass; all claims below survived 3-vote adversarial verification against primary sources.
+
+- **The substrate:** Upworthy Research Archive — every A/B test Upworthy fielded Jan 2013–Apr 2015: 32,487 experiments, 150,817 package arms, 538M assignments, randomized (Matias et al., Scientific Data 2021). A 2024 correction flagged unreliable randomization in ~22% of tests; images recorded as IDs only, so some headline effects partly reflect image packaging. <https://pmc.ncbi.nlm.nih.gov/articles/PMC8329003/>
+- **Negativity/stakes lift clicks:** each additional negative word ≈ +2.3% CTR (Robertson et al., Nature Human Behaviour 2023); confirmed in a pre-registered replication (Gligorić et al., PLOS ONE 2023). <https://www.nature.com/articles/s41562-023-01538-4>
+- **Positive puffery weakly hurts; emotional intensity helps regardless of valence** (Banerjee & Urminsky, Marketing Science 2024). The positivity-hurts effect is fragile — failed one strict confirmatory test; weak prior only. <https://home.uchicago.edu/ourminsky/Banerjee_Urminsky_Headlines.pdf>
+- **Longer informative headlines beat shorter variants** within A/B pairs (pilot coef 0.1209, p<0.001; replicated). Specific to web heads — subject-line truncation (~60 chars) is a separate, mechanical constraint. <https://www.cs.toronto.edu/~ashton/pubs/text-success-upworthy-plosone2021.pdf>
+- **Concreteness is an inverted-U:** state the core fact, keep one loop open — adding concreteness helps vague headlines and hurts already-concrete ones (interaction β=−0.058, p<0.001; Aubin Le Quéré & Matias, Scientific Reports 2025, pre-registered). Both blind teases and full giveaways lose. <https://www.nature.com/articles/s41598-024-81575-9>
+- **Numbers, concreteness, and stories about individuals increased clicks**; direct reader address ("you"/"we") slightly decreased them in that corpus (2-1 verification vote — treat as weak). Banerjee & Urminsky 2024.
+- **The ceiling:** word-level features predict the winning variant of an A/B pair only ~55% of the time (55.23% pilot; 54.42% on 24,333 held-out pairs), and prior literature predicted direction wrong more often than right. This is why the skill generates many distinct candidates instead of optimizing one.
+- **Pitch reality:** 88% of journalists immediately disregard pitches that miss their beat; they value beat relevance (70%), interview access (58%), original data (40%), and images (37%) over copy quality (Muck Rack State of Journalism 2026; vendor survey, self-report). No subject line fixes a wrong recipient. <https://muckrack.com/resources/research/state-of-journalism>
+- **Refuted in verification (do not cite):** that forward-reference curiosity-gap cues (withheld referents) significantly increase CTR — 0-3 against Banerjee & Urminsky. No surviving positive evidence for subject-withholding tease devices.
+
+Standing caveat: nearly all quantitative findings come from one clickbait-era outlet (Upworthy, 2013–2015). Directions replicated across three independent teams; magnitudes may not transfer to straight news or B2B email.

package/skills-manifest.json

@@ -1,8 +1,8 @@
 {
-  "version": "v0.1.9",
-  "npm_version": "0.1.9",
-  "commit": "8c0ba44855450e68b4e8cc382b2e3ad3ecedc404",
-  "built_at": "2026-06-09T13:29:44.710Z",
+  "version": "v0.1.10",
+  "npm_version": "0.1.10",
+  "commit": "8bbacfe9f5e21137561014b8e151004dbe7b9bd4",
+  "built_at": "2026-06-12T05:16:01.567Z",
   "distribution": "npm",
   "skills": [
     "angle-generator",
@@ -11,6 +11,7 @@
     "crisis-holding",
     "fact-check",
     "find-journalists",
+    "headline-generator",
     "journalist-fit-check",
     "meanest-editor",
     "news-search",
@@ -70,6 +71,16 @@
       "sha256": "1e5fda9bbc6fe293f3c656cfd6d1b2f38266f657acefafca39918295462a4f57",
       "size": 18772
     },
+    {
+      "path": "skills/headline-generator/SKILL.md",
+      "sha256": "4a05e630f40a63627eda74e6682c54001ba8e9265cddddd0def43303d7e9370e",
+      "size": 13106
+    },
+    {
+      "path": "skills/headline-generator/evidence.md",
+      "sha256": "dfc0006841337ff3bc9d934055a20735ba4a4a6467523391fe22862bf8d9c707",
+      "size": 10042
+    },
     {
       "path": "skills/journalist-fit-check/SKILL.md",
       "sha256": "b68f02fe91740afcbbad998a67b92909256eae793cb1719a8394f7b92fae20de",