bluf-rewriter
Reorganizes a memo, email, status update, or report so the bottom line is up front. Implements Kramon's BLUF (Bottom Line Up Front) rule. Use when a draft…
Rewrites section titles, slide titles, op-ed headlines, email subject lines, and chapter headings from category labels into bold arguable claims. Implements Constine's "punchy slide titles that tell the story" rule and Kingsbury's NYT Opinion guidance that headlines should make
$ npx -y skills add kalyvask/winning-writing --skill headline-as-claim --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/headline-as-claimContext preview
The summary Claude sees to decide when to auto-load this skill.
Rewrites section titles, slide titles, op-ed headlines, email subject lines, and chapter headings from category labels into bold arguable claims. Implements Constine's "punchy slide titles that tell the story" rule and Kingsbury's NYT Opinion guidance that headlines should make
name: headline-as-claim description: Rewrites section titles, slide titles, op-ed headlines, email subject lines, and chapter headings from category labels into bold arguable claims. Implements Constine's "punchy slide titles that tell the story" rule and Kingsbury's NYT Opinion guidance that headlines should make a bold claim, not a neutral description. Use when the user has titles like "Product," "Market," "Background," "Why this matters" — labels that waste the reader's eye. Triggers on "slide titles," "section headings," "op-ed headline," "subject line," "chapter title," "punchy title," "scannable."
Source: Josh Constine's *Fundraising Guide* ("punchy slide titles that tell the story of each slide, not just 'Product' or 'Market'") + Katie Kingsbury / NYT Opinion's headline rules + the existing `op-ed-coach` headline guidance.
Most documents are built on category labels:
> *"Product" / "Market" / "Team" / "Why Now" / "Background" / "Conclusion"*
These titles waste eye-time. The reader sees "Market" and learns nothing — they have to read the section to find out what the market claim is. A *claim* title, by contrast, IS the section if scanned.
> *"Our AI cuts notarization time 85%"* (Constine example) > *"Olympians earn the IOC billions. Guess who the IOC almost never pays."* (Kristof headline) > *"$14B in U.S. recall costs come from connector-seating failures."*
A document with claim-titles is **scannable**. A reader who reads only the titles still gets the argument. A reader who reads the body gets the evidence. Both are served.
The same rule everywhere: **a title earns its place by making a claim, not by labeling a category.**
*"Product." "Market." "Background." "About Us."* The reader's brain registers "section coming" and moves on. Wasted real estate.
*"How AI is transforming education." "Some thoughts on Olympic compensation." "An overview of our Q3."* Better than labels, still forgettable. No specific claim, nothing arguable.
*"Is AI overhyped?" / "What's wrong with healthcare?"* Sometimes works, more often dodges. A question lets the writer avoid committing. Replace with the answer.
*"Some considerations on…" "A look at…" "Thoughts on…"* Throat-clearing. Hedge titles are a signal the writer wasn't ready to make a claim yet.
A claim title has three properties:
1. **It's specific.** Names a number, a person, a place, an outcome. 2. **It's arguable.** Someone could disagree. *"AI is here"* is not arguable. *"The first AI agent in your company will be a junior analyst, not a senior one"* is. 3. **The reader can predict the section's content from the title alone.** If the title says "Sierra agents replace 47% of customer-service tickets at Nordstrom in 4 weeks" — the reader knows what's coming and can decide whether to dig in.
| ❌ Label | ✅ Claim | |---|---| | Product | Our AI cuts notarization time by 85% | | Market | $14B in U.S. recall costs come from connector failures | | Why Now | The Transformer paper finally made eval pipelines feasible in 2024 | | Team | Three of us shipped the first eval pipeline for the agent stack at `[prior company]` | | Competition | Three companies tried this 2018–2022. All died of the same thing: they trained on synthetic data. | | Traction | 500 signups per week, 70% from outdated incumbents | | Raise | $1.5M SAFE, lead in from Tier-1 fund |
| ❌ Description | ✅ Claim | |---|---| | Some thoughts on AI in education | AI tutors are widening the gap they were supposed to close | | The state of options trading | Option trading is rigged against average investors | | Olympic compensation today | Olympians earn the IOC billions. Guess who the IOC almost never pays. | | On gender stereotypes in toys | Why women should coach boys' sports |
| ❌ Generic | ✅ Personal claim | |---|---| | Hoping to connect | [unusual prior identity] turned [current credential] | | Quick question about Sierra | The trust-calibration gap you named — I have 100 interviews on why it keeps breaking | | Coffee chat? | A specific shared object or moment between sender and recipient, referenced concretely | | Re: your podcast appearance | From a fellow [small, named, shared institution or group] |
| ❌ Label | ✅ Claim | |---|---| | Q3 Update | Q3 forecast: cutting by 50%, recommend you call the board | | Hiring Plan | We need to triple the platform team by April or we miss the renewal window | | Project Status | Authentication migration is done. The session bug isn't. |
Scan the document. Mark every heading, slide title, subject line, and section break. Mark each one:
Anything that isn't C needs a rewrite.
For each non-C heading, read the section it titles. The claim title almost always exists in the section's body — usually in paragraph 1 or 2. Promote it to the title. The body is then evidence for the title's claim.
The section was making no argument. Either kill the section or write the missing claim — that's a deeper edit and a signal the document needs more work than just retitling.
31 Claude skills for cold outreach, op-eds, pitches, press inquiries, bios, exec memos, performance reviews, spoken-delivery talks, fact-checking, and reply-rate tracking.
Repo: kalyvask/winning-writing
Reorganizes a memo, email, status update, or report so the bottom line is up front. Implements Kramon's BLUF (Bottom Line Up Front) rule. Use when a draft…
Cuts a draft to a target word count without losing substance. Two modes behind one skill. target-count hits a specific number (200 for a cold email, 500 for an…
Rewrites blunt downward or peer feedback as "what I like plus what I would like," focused on the work rather than the person, ideally phrased as a question.…
Finds the unexpected, dry, or self-deprecating angle that makes an email memorable. Turns "professional and polite" into "this person sounds like a real…
Cuts cinematic details that don't serve the main point. The opposite move from vividness. Vividness adds sensory detail; this skill removes detail that's vivid…
Diagnoses drafts that tell three half-stories instead of one full story, and rewrites them around the single strongest narrative thread. Implements Konrad's…