Skip to main content
skill CX Codex

journalism-ap — Claude Code skill: AP Style news and press releases

A skill that holds the agent to Associated Press conventions when drafting news copy and press releases: attribution, numbers, dates, no editorializing. Useful when the text has to read as factual reporting.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add surendranb/writing-skills --skill journalism-ap -a claude-code
Open on GitHub

What journalism-ap does

The skill sets editorial discipline for AP work. Lead with the news — who, what, when, where — push the why into the second paragraph, attribute every claim to a named source using neutral verbs of saying, then apply the number and date conventions. Quotes carry opinion; the narration stays flat.

Inside are the workflow and a verification checklist. Inverted pyramid: the opening sentence carries the news, each paragraph after adds less critical detail, so an editor can cut from the bottom. Spell out one through nine, use figures from 10 up. Years, ages, dates and percentages are always figures, with the % symbol. Months are abbreviated in dates except March, April, May, June and July.

Formal titles take a capital before a name and lowercase after it. Anonymous sourcing needs a stated reason. Paragraphs run no longer than two sentences. The skill does not rewrite anything on its own — it supplies the rules the agent writes and checks against, so it only fires when you ask for a draft or a review.

What it helps with

  • draft a funding press release without promotional language
  • bring numbers and dates in a draft in line with AP rules
  • rewrite copy so every claim carries attribution
  • strip opinion words out of a news summary
  • break a story into short paragraphs under the inverted pyramid

Example prompts for the agent

  • Write an AP Style press release about our Series B round, with attribution and no editorializing.
  • Check this news draft: where does attribution break, and which numbers or dates are wrong?
  • Rewrite the opening paragraph so it answers who, what, when and where, and move the reason to the second one.

How to install journalism-ap

1Skills CLI (Vercel)

npx skills add surendranb/writing-skills --skill journalism-ap -a claude-code

2Manually: put the files in place

~/.claude/skills/journalism-ap/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/journalism-ap/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about journalism-ap

How do I install journalism-ap in Claude Code?

Run npx skills add surendranb/writing-skills --skill journalism-ap -a claude-code. The skill file lands at ~/.claude/skills/journalism-ap/SKILL.md.

What does journalism-ap do?

It gives the agent AP rules for news and press releases: inverted pyramid, attribution through neutral verbs, standard number and date handling, and a ban on opinion words. It also ships a checklist for reviewing finished copy.

How is journalism-ap different from just asking for a press release?

The skill pins down specifics: one through nine spelled out, figures from 10 up, percentages with the % symbol, months abbreviated in dates. It also requires attribution on each claim and keeps judgement out of the narration.

Source text

SKILL.md · MIT
---
name: journalism-ap
description: Write news, press releases, and journalistic content to the Associated Press Stylebook essentials — attribution, numbers, dates, no editorializing. Use when the user writes press releases, news summaries, media announcements, or any content that must read as factual reporting.
---

# Journalism (AP Style Essentials)

Facts, attribution, restraint. The writer disappears; the story stays.

## The core rule

**Report, don't opine — and make every claim attributable.** AP journalism is disciplined by two questions: "Can this be attributed?" and "Is this my opinion leaking in?" If either fails, the sentence changes.

Workflow: `lead with the news (who, what, when, where — why in the second graph)` → `attribute claims to named sources with verbs of saying` → `follow number/date/title conventions exactly` → `let quotes carry opinion; the narration stays neutral`.

## Mechanics

1. **Inverted pyramid.** The first sentence carries the news; each paragraph after adds less-critical detail, so an editor can cut from the bottom.
2. **Lead answers the 5 Ws.** Who did what, when, where — and why/impact in the second graph.
3. **Attribution discipline.** "according to the police report", "said Maria Chen, the company's CEO". The reporter's job is "said" — neutral verbs only (said, told, according to). Not "claimed" (implies doubt) unless reporting a disputed fact.
4. **Quote handling.** Quotes are exactly what was said; paraphrase the rest. New speaker = new paragraph.
5. **Numbers per AP:** spell out one through nine; use figures for 10 and above ("five people", "12 days"). Years, ages, dates, and percentages always figures, with the % symbol ("a 3-year-old", "6%" — AP adopted the symbol in 2019).
6. **Dates and time:** "Aug. 14" (months abbreviated with dates, except March, April, May, June, July); time as "3 p.m." not "3:00pm".
7. **Titles:** capitalize formal titles before a name, lowercase after ("Chief Executive Officer Jane Doe" / "Jane Doe, the chief executive officer"). First reference typically uses full name; later just the last name.
8. **No editorializing.** No "clearly", "unfortunately", "shockingly", "in a surprising move". The facts create the drama.
9. **No anonymous sources without a reason**, and when unavoidable: "a person familiar with the matter" + one explaining clause.
10. **Short graphs.** One to two sentences per paragraph; paragraphs stand alone.

## Verify

- First sentence answers who/what/when/where
- Every factual claim is attributable or self-evident
- No opinion words (clearly, unfortunately, surprisingly, importantly, notably)
- Numbers follow AP rules (1–9 spelled, 10+ figures, % symbol with figures)
- No unattributed quotes; quotes use exactly the words spoken
- Paragraphs ≤ 2 sentences

## Do not

- Use "claimed/alleged" when "said" is honest — reserve them for genuine dispute
- Put your judgment in the narration; quotes carry it
- Start a news release with the company's name or history

## Example transformations

**Before:** "We are thrilled to announce that our incredible company has successfully raised an amazing $25 million, which will enable us to continue our incredible journey of transforming the industry!"

**After:** "Aurora Labs has raised $25 million in Series B funding, the company said Thursday. The round was led by Meridian Capital with participation from existing investors. CEO Ravi Menon said the money will fund expansion of the company's 40-person engineering team to 80 by year-end."

**Before:** "5 employees were shocked and saddened as the company announced layoffs affecting over 30% of the workforce, in what many see as a disastrous strategic decision."

**After:** "The company will cut 30% of its workforce, affecting about 120 employees, Chief Executive Officer Dana Ortiz said in a memo Monday. Ortiz cited slowing revenue growth as the reason. The layoffs take effect Sept. 1."

© surendranb · MIT · surendranb/writing-skills

Similar skills

All skills for Writing and docs →

From the same set4

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor