# plain-language

Скилл переписывает черновики простым языком: короткие фразы, активный залог, без канцелярита. Пригодится для текстов, которые читают один раз.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 53
- Автор: surendranb
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/surendranb/writing-skills/tree/HEAD/skills/plain-language/SKILL.md
- Обновлён: 2026-09-02
- HTML: https://affpapa.org/nevibecode/skills/plain-language

## Что делает

Скилл задаёт набор правил письма по US Plain Writing Act of 2010 и материалам Plain Language Action Network. Главное требование — читатель находит, понимает и использует нужное с первого прочтения. Дальше идут механики: смысл в начало, предложения в среднем 15–20 слов, потолок около 25, одна мысль на предложение, активный залог, простые слова вместо латинизмов.

Работает это как порядок шагов: определить читателя и его действие, вынести ключевую мысль вперёд, вырезать лишние слова, прогнать проверку. В проверке — длина предложений, доля пассивного залога не выше примерно 10%, список запрещённых канцелярских слов вроде utilize, leverage, pursuant to, оценка Flesch Reading Ease не ниже 60 и чтение вслух.

Оговорка в самом скилле: там, где термин несёт юридическую или техническую нагрузку, точность важнее краткости. Определения тоже не выбрасываются — простой язык объясняет, а не подразумевает. Если ваш текст — юридическая формулировка, где каждое слово держит смысл, скилл её переписывать не станет.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add surendranb/writing-skills --skill plain-language -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/plain-language/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/plain-language/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add surendranb/writing-skills --skill plain-language -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/plain-language/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add surendranb/writing-skills --skill plain-language -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/plain-language/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install surendranb/writing-skills plain-language
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/plain-language/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add surendranb/writing-skills --skill plain-language -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/surendranb/writing-skills --path skills/plain-language
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/plain-language/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add surendranb/writing-skills --skill plain-language -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/surendranb/writing-skills/tree/HEAD/skills/plain-language/SKILL.md

## Когда брать
- переписать черновик инструкции так, чтобы читатель понял с первого раза
- убрать канцелярит и пассивный залог из публичного текста
- сократить длинные предложения до 25 слов и меньше
- проверить текст на читаемость по Flesch Reading Ease
- привести заголовки к виду «как подать заявку», «что будет дальше»

## Примеры запросов агенту
- Перепиши этот текст простым языком, предложения не длиннее 25 слов.
- Убери канцелярит из абзаца про порядок возмещения расходов.
- Проверь черновик по чек-листу скилла и покажи, где пассивный залог.

## Похожие
- [plain-language-letters](https://affpapa.org/nevibecode/skills/plain-language-letters.md) — скилл · 602 установки
- [eli5](https://affpapa.org/nevibecode/skills/mblode-eli5.md) — скилл · 313 установок
- [readability](https://affpapa.org/nevibecode/skills/readability.md) — скилл · 574 установки
- [GEML — a plain-text document format built to be edited in place, one section at a time](https://affpapa.org/nevibecode/mcp/geml-a-plain-text-document-format-built-to-be-edited-in-place-one-section-at-a-t.md) — MCP-сервер · ★ 29
- [language-evolution](https://affpapa.org/nevibecode/skills/language-evolution.md) — скилл · 428 установок
- [engineering-blog-post](https://affpapa.org/nevibecode/skills/engineering-blog-post.md) — скилл · 10300 установок

Из того же набора: [surendranb/writing-skills](https://affpapa.org/nevibecode/by/surendranb/writing-skills.md) — 4 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md