gov-uk-style — скилл для Claude Code: что делает и как установить
Скилл помогает писать понятные публичные тексты по принципам GOV.UK. Используйте его для справок, описаний услуг и кратких изложений политик.
npx skills add surendranb/writing-skills --skill gov-uk-style -a claude-codeЧто делает gov-uk-style
Скилл предлагает начинать с потребности читателя, писать короткими фразами и выбирать активный залог. Для шагов и условий он рекомендует списки, а вводные фразы и жаргон — убирать. Жирное выделение оставляет для важных предупреждений и критериев.
Внутри — правила и проверочный список: например, проверить первое предложение, длину фраз и наличие латинских сокращений. Скиллу нужны стандартный Markdown-парсер и контекст агента. Если агент не получает контекст, ему не на что опереться при редактировании.
Какие задачи решает
- переписать справку простым языком
- разбить условия подачи заявки на пункты
- убрать пассивный залог из инструкции
- проверить текст на вводные фразы и латинские сокращения
Примеры запросов агенту
- Перепиши эту справку по правилам GOV.UK: начни с того, что читатель может сделать.
- Преобразуй условия подачи заявки в короткие активные фразы и список.
- Проверь эту инструкцию на жаргон, пассивный залог и лишние вводные фразы.
Как установить gov-uk-style
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill gov-uk-style -a claude-code2Вручную: положить файлы
~/.claude/skills/gov-uk-style/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gov-uk-style/
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill gov-uk-style -a codex2Вручную: положить файлы
.agents/skills/gov-uk-style/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill gov-uk-style -a cursor2Вручную: положить файлы
.cursor/skills/gov-uk-style/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install surendranb/writing-skills gov-uk-style2Вручную: положить файлы
.github/skills/gov-uk-style/SKILL.md1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill gov-uk-style -a gemini-cli2Командой платформы
gemini skills install https://github.com/surendranb/writing-skills --path skills/gov-uk-styleВручную: положить файлы
.devin/skills/gov-uk-style/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill gov-uk-style -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gov-uk-style
Как установить gov-uk-style в Claude Code?
Выполните npx skills add surendranb/writing-skills --skill gov-uk-style -a claude-code. Файл скилла находится по пути ~/.claude/skills/gov-uk-style/SKILL.md.
Что делает gov-uk-style?
Он задаёт правила для понятных публичных текстов: ставить потребность читателя на первое место, писать активно и использовать списки для шагов и условий.
Что нужно для работы gov-uk-style?
Нужны стандартный Markdown-парсер и контекст агента.
Исходный текст
SKILL.md · MIT
---
name: gov-uk-style
description: Use when writing public-facing content, government or civic communication, help pages, policy summaries, or content requiring maximum-scope readability according to GOV.UK standards.
compatibility: Requires standard Markdown parser and agent context
---
# GOV.UK Style
Make complex information instantly clear, scannable, and accessible to every citizen.
## The core rule
**Start with the user's need. Sentences under 25 words, paragraphs under 5 lines, active voice, zero jargon.**
Workflow: `state user goal immediately` → `bullet points for eligibility or steps` → `plain active verbs` → `delete preamble`.
## Mechanics
1. **User need first.** Every page starts with what the user can do or find.
2. **Short sentences.** Maximum 25 words; vary length for rhythm.
3. **Active voice.** "You must apply online" not "Applications must be submitted".
4. **No jargon.** Replace bureaucratic terms with plain English (e.g. "pay" instead of "remuneration").
5. **Bulleted lists for steps.** Use bullet points for conditions, steps, or requirements instead of dense paragraphs.
6. **Bold sparingly.** Use bold only for critical warnings or key criteria.
7. **No Latin or Latinisms.** Use "for example" instead of "e.g." and "that is" instead of "i.e.".
8. **Anchor links.** Clear, descriptive link text that explains where the link goes.
## Verify
- First sentence directly addresses the user's primary intent
- Sentences average under 20 words
- Bullet points used for lists of 3 or more items
- Zero Latin abbreviations (e.g., i.e., et al.)
- Active voice used throughout
## Do not
- Use introductory throat-clearing ("It is important to note that...")
- Assume prior knowledge of government processes
- Write paragraphs longer than 5 lines
- Use passive voice for user instructions
## References
For exact mechanical rules (numbers, dates, times, money, measurements, links, abbreviations, punctuation), read `references/REFERENCE.md` when a draft includes any of these — load on demand, not upfront.
## Example transformations
**Before:** "In the event that an individual wishes to make an application for financial assistance, it is required that they submit documentation demonstrating eligibility prior to the commencement of the review process."
**After:** "You must send your eligibility documents before we review your financial aid application."
**Before:** "Users should note that e.g. tax returns must be filed by January 31st i.e. the end of the month."
**After:** "You must file your tax return by 31 January."
© surendranb · MIT · surendranb/writing-skills