MCPInstall

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
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads newsroom-style automatically when relevant.

  3. 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

RuleExample
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 percentagesAP 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

RuleExample
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 referenceFirst: "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

DoDon't
"said""stated," "remarked," "noted," "expressed"
Attribution after quoteAttribution before quote
At first natural pauseAt 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

UseInstead of
more thanover (for quantities)
fewerless (for countable items)
lessfewer (for mass nouns)
thatwhich (for restrictive clauses)
whichthat (for nonrestrictive clauses)
saidstated, remarked, noted
aboutapproximately
becausedue 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

View all →

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.

Docs & Writing2.9K installs

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.

DevOps & Cloud604 installs

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.

Docs & Writing505 installs

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.

Media & Creative426 installs

Popular docs & writing skills

View category →

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.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs