# technical-writing

Скилл заставляет агента писать прозу в стиле Simplified Technical English: короткие предложения, активный залог, одно слово — одно значение. Для документации, README и коммитов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 514 установок · ★ 158
- Автор: frappe
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/frappe/skills/tree/HEAD/skills/technical-writing/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/frappe-technical-writing

## Что делает

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

Правила разложены по блокам. В словах — один предмет называется одним именем, короткое слово вместо длинного (`start`, а не `commence`; `use`, а не `utilize`). В глаголах — активный залог и запрет прятать действие в существительное: не «perform an analysis», а «analyze». В предложениях — лимит в 20 слов для инструкции и 25 для описания, без сокращений и без трёх существительных подряд. Отдельный блок про структуру: один абзац — одна тема, не больше шести предложений, шаги нумерованным списком.

Скилл не для всего подряд. Маркетинговые тексты, эссе и код он не трогает — там нужен голос, а не регламент. Ещё он требует американское написание, так что в проекте с британской орфографией ждите правок в другую сторону. Точку с запятой правила запрещают, а тире оставляют на ваше усмотрение.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install frappe/skills technical-writing
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- привести README к одному стилю без длинных предложений
- переписать описание коммита так, чтобы действие было видно
- убрать из документации маркетинговые прилагательные
- разбить инструкцию на шаги по одному действию в каждом
- вычистить канцелярит из плана и заметок к релизу

## Примеры запросов агенту
- Перепиши `README.md` по правилам Simplified Technical English
- Сократи описание пул-реквеста: активный залог, не больше 20 слов в предложении
- Пройдись по `docs/setup.md` и убери лишние слова, смысл не меняй

## Похожие
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [handoff](https://affpapa.org/nevibecode/skills/handoff.md) — скилл · 1038491 установка
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [domain-modeling](https://affpapa.org/nevibecode/skills/domain-modeling.md) — скилл · 876391 установка

## Другие версии с тем же именем
- [technical-writing · backnotprop](https://affpapa.org/nevibecode/skills/backnotprop-technical-writing.md) — 5500 установок
- [technical-writing · mindrally](https://affpapa.org/nevibecode/skills/mindrally-technical-writing.md) — 1200 установок
- [technical-writing · akillness](https://affpapa.org/nevibecode/skills/akillness-technical-writing.md) — 544 установки

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

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