journalism-ap — скилл для Claude Code: новости и пресс-релизы по AP Style
Скилл для написания новостей и пресс-релизов по канонам Associated Press: атрибуция, числа, даты, без оценочных суждений. Пригодится, когда текст должен читаться как фактологический отчёт.
npx skills add surendranb/writing-skills --skill journalism-ap -a claude-codeЧто делает journalism-ap
Скилл задаёт агенту редакторскую дисциплину AP: сначала новость (кто, что, когда, где), затем атрибуция утверждений именованным источникам через нейтральные глаголы говорения, затем числа и даты по правилам. Цитаты передаются дословно, мнение несут только они — повествование остаётся нейтральным.
Внутри — рабочий процесс и чек-лист проверки. Перевёрнутая пирамида: первое предложение несёт новость, каждый следующий абзац добавляет менее важные детали, поэтому редактор может резать снизу. Числа от одного до девяти пишутся словами, от 10 — цифрами; годы, возраст, даты и проценты всегда цифрами, с символом %. Месяцы в датах сокращаются, кроме March, April, May, June, July.
Формальные титулы перед именем пишутся с заглавной, после имени — со строчной. Анонимные источники допустимы только с объяснением, почему имя не называется. Абзацы — не больше двух предложений. Скилл ничего не делает с уже готовым текстом сам: он задаёт правила, по которым агент пишет и проверяет черновик, так что без запроса на написание или вычитку он не сработает.
Какие задачи решает
- написать пресс-релиз о раунде финансирования без рекламных эпитетов
- привести числа и даты в тексте к правилам AP
- переписать черновик так, чтобы каждое утверждение было атрибутировано
- убрать оценочные слова из новостной заметки
- собрать короткие абзацы по перевёрнутой пирамиде
Примеры запросов агенту
- Напиши пресс-релиз по AP Style о том, что компания привлекла раунд B, с атрибуцией и без оценочных слов.
- Проверь этот черновик новости: где нарушена атрибуция и правила чисел и дат?
- Перепиши первый абзац так, чтобы он отвечал на кто, что, когда и где, а причина ушла во второй.
Как установить journalism-ap
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill journalism-ap -a claude-code2Вручную: положить файлы
~/.claude/skills/journalism-ap/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/journalism-ap/
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill journalism-ap -a codex2Вручную: положить файлы
.agents/skills/journalism-ap/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill journalism-ap -a cursor2Вручную: положить файлы
.cursor/skills/journalism-ap/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install surendranb/writing-skills journalism-ap2Вручную: положить файлы
.github/skills/journalism-ap/SKILL.md1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill journalism-ap -a gemini-cli2Командой платформы
gemini skills install https://github.com/surendranb/writing-skills --path skills/journalism-apВручную: положить файлы
.devin/skills/journalism-ap/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill journalism-ap -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о journalism-ap
Как установить journalism-ap в Claude Code?
Выполните npx skills add surendranb/writing-skills --skill journalism-ap -a claude-code. Файл скилла окажется по пути ~/.claude/skills/journalism-ap/SKILL.md.
Что делает journalism-ap?
Задаёт агенту правила AP для новостей и пресс-релизов: перевёрнутая пирамида, атрибуция через нейтральные глаголы, числа и даты по стандарту, запрет на оценочные слова. Плюс чек-лист для проверки готового текста.
Чем journalism-ap отличается от обычного запроса написать пресс-релиз?
Скилл фиксирует конкретные правила: числа от одного до девяти словами, от 10 цифрами, проценты с символом %, месяцы в датах сокращаются. Ещё он требует атрибуции каждого утверждения и не даёт вставлять мнение в повествование.
Исходный текст
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