/newsroom-style
Enforce AP Style and newsroom conventions for journalism writing. Use when writing news articles, editing drafts, creating headlines, or converting notes into publishable copy. Ensures professional standards for attribution, numbers, dates, and formatting.
$ npx -y skills add jamditis/claude-skills-journalism --skill newsroom-style --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/newsroom-style
Context preview
The summary Claude sees to decide when to auto-load this skill.
Enforce AP Style and newsroom conventions for journalism writing. Use when writing news articles, editing drafts, creating headlines, or converting notes into publishable copy. Ensures professional standards for attribution, numbers, dates, and formatting.
SKILL.md
newsroom-style.SKILL.mdname: newsroom-style
description: Enforce AP Style and newsroom conventions for journalism writing. Use when writing news articles, editing drafts, creating headlines, or converting notes into publishable copy. Ensures professional standards for attribution, numbers, dates, and formatting.
Newsroom style guide
Write like a professional journalist. Follow AP Style. Keep it tight.
When to use
- Writing news articles, briefs, or headlines
- Editing drafts for publication
- Converting interview notes into publishable copy
- Writing press releases or media advisories
- Creating social media posts for news content
Core AP Style rules
Numbers
| Rule | Example | |------|---------| | Spell out one through nine | "three witnesses" not "3 witnesses" | | Use numerals for 10 and above | "15 people attended" | | Always use numerals for ages | "a 5-year-old girl" | | Always use numerals for percentages | AP allows the `%` symbol with numerals (`5%`) since 2019; some publications still spell out "percent" as house style | | Always use numerals for addresses | "123 Main St." | | Always use numerals for money | "$5 million" not "five million dollars" | | Spell out first through ninth for ordinals | "first place" but "10th anniversary" |
**Exception:** Never start a sentence with a numeral. Rewrite or spell out.
Titles and names
| Rule | Example | |------|---------| | Capitalize formal titles before names | "Mayor Jane Smith said..." | | Lowercase titles after names | "Jane Smith, the mayor, said..." | | Lowercase titles standing alone | "The mayor said..." | | No courtesy titles on second reference | First: "Jane Smith." Second: "Smith" | | Use full name on first reference | "Jane Smith" not "Smith" or "Ms. Smith" |
**Exceptions:**
- Use courtesy titles in obituaries
- Some publications use them for all subjects (house style)
Attribution
| Do | Don't | |----|-------| | "said" | "stated," "remarked," "noted," "expressed" | | Attribution after quote | Attribution before quote | | At first natural pause | At awkward break |
**Examples:**
**Bad:** Mayor Smith stated, "We are committed to this project."
**Good:** "We are committed to this project," Mayor Smith said.
**Good:** "We are committed to this project," said Mayor Jane Smith, who has pushed for the development since 2022.
Dates and times
**Months:**
- Abbreviate: Jan., Feb., Aug., Sept., Oct., Nov., Dec.
- Don't abbreviate: March, April, May, June, July
- Only abbreviate with specific dates: "Sept. 15" but "September 2025"
**Times:**
- Use figures with a.m./p.m.: "9 a.m." not "9:00 a.m."
- Noon and midnight: Use the words, not "12 p.m." or "12 a.m."
- Time ranges: "9 a.m. to 5 p.m." or "9-11 a.m."
**Days:**
- Capitalize days of the week
- Don't abbreviate except in tables
- Use "Tuesday" not "on Tuesday" when possible
Common word choices
| Use | Instead of | |-----|-----------| | more than | over (for quantities) | | fewer | less (for countable items) | | less | fewer (for mass nouns) | | that | which (for restrictive clauses) | | which | that (for nonrestrictive clauses) | | said | stated, remarked, noted | | about | approximately | | because | due to the fact that |
Restrictive vs. nonrestrictive clauses
**Restrictive (essential, use "that"):** > The bill that passed yesterday includes tax cuts.
(Which bill? The one that passed yesterday.)
**Nonrestrictive (extra info, use "which" + comma):** > The bill, which passed yesterday, includes tax cuts.
(We already know which bill; the passage is extra info.)
Formatting rules
Paragraphs
- Keep paragraphs short: 1-3 sentences
- One idea per paragraph
- Break up long quotes into multiple paragraphs
Headlines
- Use sentence case, not title case
- No periods at the end
- Use present tense for past events: "Council approves budget"
- Use infinitive for future events: "Mayor to announce plan"
- No exclamation points in hard news
Quotation marks
- Periods and commas always go inside
- Colons and semicolons always go outside
- Question marks and exclamation points: inside if part of quote, outside if not
Abbreviations
- Spell out on first reference, then abbreviate
- Don't use periods in most abbreviations: FBI, CIA, NATO
- State abbreviations: Use postal codes (NY, CA) only with full addresses; otherwise use AP abbreviations or spell out
Ledes (opening paragraphs)
The inverted pyramid
Most important information first. Answer the key questions:
- **Who** is involved?
- **What** happened?
- **When** did it happen?
- **Where** did it happen?
- **Why** did it happen? (if known)
- **How** did it happen? (if relevant)
Lede length
- Aim for 35 words or fewer
- One sentence is ideal
- Focus on the news, not background
**Too long:** > The city council, which has been debating the issue for several months and heard from dozens of residents at multiple public meetings, voted Tuesday night to approve a controversial new zoning ordinance that would allow high-rise buildings in the downtown area.
**Better:** > The city council approved a zoning ordinance Tuesday that allows high-rise buildings downtown, ending months of debate.
Types of ledes
**Hard news lede:** > A fire killed three people in Northeast Philadelphia early Tuesday.
**Feature lede:** > The last time Maria Rodriguez saw her mother, she promised to bring her to America.
**Question lede (use sparingly):** > What happens when a city runs out of money?
Quick reference card
Before you publish
- [ ] Names spelled correctly and verified
- [ ] Titles correct and styled properly
- [ ] Numbers follow AP Style
- [ ] Attribution uses "said"
- [ ] Dates and times formatted correctly
- [ ] Paragraphs are short
- [ ] Lede is under 35 words
- [ ] No editorializing in news copy
- [ ] Sources are credible and named
Red flags
- "Very" or "extremely" in news copy
- Exclamation points
- First-person pronouns (unless first-person piece)
- Unattributed opin
Read more
name: newsroom-style description: Enforce AP Style and newsroom conventions for journalism writing. Use when writing news articles, editing drafts, creating headlines, or converting notes into publishable copy. Ensures professional standards for attribution, numbers, dates, and formatting.
Newsroom style guide
Write like a professional journalist. Follow AP Style. Keep it tight.
When to use
- Writing news articles, briefs, or headlines
- Editing drafts for publication
- Converting interview notes into publishable copy
- Writing press releases or media advisories
- Creating social media posts for news content
Core AP Style rules
Numbers
| Rule | Example | |------|---------| | Spell out one through nine | "three witnesses" not "3 witnesses" | | Use numerals for 10 and above | "15 people attended" | | Always use numerals for ages | "a 5-year-old girl" | | Always use numerals for percentages | AP allows the `%` symbol with numerals (`5%`) since 2019; some publications still spell out "percent" as house style | | Always use numerals for addresses | "123 Main St." | | Always use numerals for money | "$5 million" not "five million dollars" | | Spell out first through ninth for ordinals | "first place" but "10th anniversary" |
**Exception:** Never start a sentence with a numeral. Rewrite or spell out.
Titles and names
| Rule | Example | |------|---------| | Capitalize formal titles before names | "Mayor Jane Smith said..." | | Lowercase titles after names | "Jane Smith, the mayor, said..." | | Lowercase titles standing alone | "The mayor said..." | | No courtesy titles on second reference | First: "Jane Smith." Second: "Smith" | | Use full name on first reference | "Jane Smith" not "Smith" or "Ms. Smith" |
**Exceptions:**
- Use courtesy titles in obituaries
- Some publications use them for all subjects (house style)
Attribution
| Do | Don't | |----|-------| | "said" | "stated," "remarked," "noted," "expressed" | | Attribution after quote | Attribution before quote | | At first natural pause | At awkward break |
**Examples:**
**Bad:** Mayor Smith stated, "We are committed to this project."
**Good:** "We are committed to this project," Mayor Smith said.
**Good:** "We are committed to this project," said Mayor Jane Smith, who has pushed for the development since 2022.
Dates and times
**Months:**
- Abbreviate: Jan., Feb., Aug., Sept., Oct., Nov., Dec.
- Don't abbreviate: March, April, May, June, July
- Only abbreviate with specific dates: "Sept. 15" but "September 2025"
**Times:**
- Use figures with a.m./p.m.: "9 a.m." not "9:00 a.m."
- Noon and midnight: Use the words, not "12 p.m." or "12 a.m."
- Time ranges: "9 a.m. to 5 p.m." or "9-11 a.m."
**Days:**
- Capitalize days of the week
- Don't abbreviate except in tables
- Use "Tuesday" not "on Tuesday" when possible
Common word choices
| Use | Instead of | |-----|-----------| | more than | over (for quantities) | | fewer | less (for countable items) | | less | fewer (for mass nouns) | | that | which (for restrictive clauses) | | which | that (for nonrestrictive clauses) | | said | stated, remarked, noted | | about | approximately | | because | due to the fact that |
Restrictive vs. nonrestrictive clauses
**Restrictive (essential, use "that"):** > The bill that passed yesterday includes tax cuts.
(Which bill? The one that passed yesterday.)
**Nonrestrictive (extra info, use "which" + comma):** > The bill, which passed yesterday, includes tax cuts.
(We already know which bill; the passage is extra info.)
Formatting rules
Paragraphs
- Keep paragraphs short: 1-3 sentences
- One idea per paragraph
- Break up long quotes into multiple paragraphs
Headlines
- Use sentence case, not title case
- No periods at the end
- Use present tense for past events: "Council approves budget"
- Use infinitive for future events: "Mayor to announce plan"
- No exclamation points in hard news
Quotation marks
- Periods and commas always go inside
- Colons and semicolons always go outside
- Question marks and exclamation points: inside if part of quote, outside if not
Abbreviations
- Spell out on first reference, then abbreviate
- Don't use periods in most abbreviations: FBI, CIA, NATO
- State abbreviations: Use postal codes (NY, CA) only with full addresses; otherwise use AP abbreviations or spell out
Ledes (opening paragraphs)
The inverted pyramid
Most important information first. Answer the key questions:
- **Who** is involved?
- **What** happened?
- **When** did it happen?
- **Where** did it happen?
- **Why** did it happen? (if known)
- **How** did it happen? (if relevant)
Lede length
- Aim for 35 words or fewer
- One sentence is ideal
- Focus on the news, not background
**Too long:** > The city council, which has been debating the issue for several months and heard from dozens of residents at multiple public meetings, voted Tuesday night to approve a controversial new zoning ordinance that would allow high-rise buildings in the downtown area.
**Better:** > The city council approved a zoning ordinance Tuesday that allows high-rise buildings downtown, ending months of debate.
Types of ledes
**Hard news lede:** > A fire killed three people in Northeast Philadelphia early Tuesday.
**Feature lede:** > The last time Maria Rodriguez saw her mother, she promised to bring her to America.
**Question lede (use sparingly):** > What happens when a city runs out of money?
Quick reference card
Before you publish
- [ ] Names spelled correctly and verified
- [ ] Titles correct and styled properly
- [ ] Numbers follow AP Style
- [ ] Attribution uses "said"
- [ ] Dates and times formatted correctly
- [ ] Paragraphs are short
- [ ] Lede is under 35 words
- [ ] No editorializing in news copy
- [ ] Sources are credible and named
Red flags
- "Very" or "extremely" in news copy
- Exclamation points
- First-person pronouns (unless first-person piece)
- Unattributed opin
A collection of Agent Skills for journalists, researchers, academics, media professionals, and communications practitioners. The same repository serves Claude Code and Codex while keeping Claude-only commands, agents, and hooks clearly labeled.
Repo: jamditis/claude-skills-journalism
Other skills on claude-skills-journalism.
- /accessibility-compliance
Web accessibility patterns for news sites, journalism tools, and academic platforms. Use when building accessible interfaces, auditing existing sites for WCAG compliance, writing alt text for news images, creating accessible data visualizations, or ensuring content reaches all
Open skill - /claude-md-updater
Use this skill when the user asks to update CLAUDE.md, save a lesson, or persist something from the current session: phrases like "update claude.md", "what should we remember", "save this lesson", or "add to context". Scans the conversation for hard-won lessons, new file paths,
Open skill - /electron-dev
Electron desktop application development with React, TypeScript, and Vite. Use when building desktop apps, implementing IPC communication, managing windows/tray, handling PTY terminals, integrating WebRTC/audio, or packaging with electron-builder. Covers patterns from AudioBash,
Open skill - /mobile-debugging
Remote JavaScript console access and debugging on mobile devices. Use when debugging web pages on phones/tablets, accessing console errors without desktop DevTools, testing responsive designs on real devices, or diagnosing mobile-specific issues. Covers locally hosted Eruda and
Open skill - /one-way-door
Use this skill when creating new files that represent architectural decisions — data models, infrastructure configs, auth boundaries, API contracts, CI/CD pipelines, or event systems. Flags irreversible decisions and forces a discussion about trade-offs before committing.
Open skill - /python-pipeline
Python data processing pipelines with modular architecture. Use when building content processing workflows, implementing dispatcher patterns, integrating Google Sheets/Drive APIs, or creating batch processing systems. Covers patterns from rosen-scraper, image-analyzer, and
Open skill

