
newsroom-style
Enforces AP Style and newsroom conventions. Use when writing news, editing drafts, creating headlines, or tightening copy.
- Installs
- 251
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/jamditis/claude-skills-journalism --skill newsroom-style- 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 newsroom-style 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.
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 opinions
- Passive voice hiding who did what
- Starting sentences with "There is" or "There are"
Example transformations
Before (informal notes):
Yesterday the Mayor said that he was "very excited" about the new $5,000,000 project that will create over 100 jobs.
After (AP Style):
Mayor John Smith said Tuesday he was "very excited" about the $5 million project, which will create more than 100 jobs.
Before:
The meeting started at 9:00 AM on Monday, October 14th, 2024.
After:
The meeting began at 9 a.m. Monday, Oct. 14, 2024.
Before:
5 protesters were arrested at the rally.
After:
Five protesters were arrested at the rally.
Before:
Smith stated that he believed the project would be "important."
After:
Smith said he believed the project would be "important."
House style notes
Different publications have their own style guides that override AP Style. Common variations:
- Oxford comma (AP doesn't use it; many publications do, verify with your editor)
- Courtesy titles (AP doesn't use them; NYT does)
- Web style (AP merged "web site" to "website" in 2010; some legacy guides still split it)
Always ask about house style before writing for a new publication.
Based on the Associated Press Stylebook. Check the current AP Stylebook (apstylebook.com) for updates and edge cases.
FAQ
What does the newsroom-style skill do?
Enforces AP Style and newsroom conventions. Use when writing news, editing drafts, creating headlines, or tightening copy.
How do I install newsroom-style?
Run npx skills add https://github.com/jamditis/claude-skills-journalism --skill newsroom-style 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/newsroom-style/ (personal) or .claude/skills/newsroom-style/ (project).
Which AI agents can use newsroom-style?
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 newsroom-style 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 newsroom-style?
It is published by jamditis in jamditis/claude-skills-journalism. It has 251 recorded installs.
More from jamditis/claude-skills-journalism
web-scraping
jamditis/claude-skills-journalism
Authorized web scraping with fallback cascades and access-failure handling. Use for social media, yt-dlp, CAPTCHA or 403 blocks.
academic-writing
jamditis/claude-skills-journalism
Scholarly writing and research compliance. Use for CRediT, preregistration, Plan S, Nelson Memo, preprints, ORCID, LLM disclosure.
page-monitoring
jamditis/claude-skills-journalism
Web page change detection, availability tracking, and RSS feed generation. Use to monitor changes, downtime, or make a feed.
fact-check-workflow
jamditis/claude-skills-journalism
Structured fact-checking workflow. Use when verifying claims for publication, rating claims, or setting pre-publication checks.
pdf-design
jamditis/claude-skills-journalism
Designs PDF reports and proposals from HTML with previews and branding. Use to create, export, or securely upload a PDF.
source-verification
jamditis/claude-skills-journalism
Verify sources, claims, images, video, documents, interviews, and synthetic media with SIFT and a durable evidence trail. Use before relying on uncertain material.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.