# reviewing-technical-prose

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 18200 установок · ★ 33
- Автор: riekelt
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/riekelt/technical-writer/tree/HEAD/plugins/technical-writer/skills/reviewing-technical-prose/SKILL.md
- Обновлён: 2026-09-13
- HTML: https://affpapa.org/nevibecode/skills/reviewing-technical-prose

## Что делает

Скилл включается, когда вы правите чужой технический текст, пишете отчёт о найденных проблемах или делаете финальную проверку собственного документа. Он задаёт три уровня серьёзности: BLOCKER — нарушение жёстких правил и утверждение, которое не подтверждается источником; WARNING — запрещённые конструкции, структурные дефекты, слабо подкреплённые заявления; OBS — двусмысленность и мелочи, которые внимательный автор поймал бы сам. Каждая находка — одно предложение с описанием дефекта, место (`file:line`, раздел, ID задачи), предлагаемая правка и уровень уверенности.

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

Скиллу нужен фоновый скилл `technical-writing` с файлами `references/style.md` и `references/truth.md` — без него проверки конструкций и правил утверждений не сработают. Для ревью кода он не годится, только для прозы в нём. И ещё: если автор доступен, показывайте diff до того, как перезаписывать его текст.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add riekelt/technical-writer --skill reviewing-technical-prose -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add riekelt/technical-writer --skill reviewing-technical-prose -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install riekelt/technical-writer reviewing-technical-prose
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add riekelt/technical-writer --skill reviewing-technical-prose -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- проверь этот документ перед сдачей и покажи находки по уровням
- перепиши абзац про миграцию, содержание не меняй
- сделай отчёт о ревью файла `docs/setup.md`

## Похожие
- [technical-content-evaluator](https://affpapa.org/nevibecode/agents/technical-content-evaluator.md) — субагент · 209 установок
- [technical-writing](https://affpapa.org/nevibecode/skills/backnotprop-technical-writing.md) — скилл · 5500 установок
- [technical-documentation](https://affpapa.org/nevibecode/skills/technical-documentation.md) — скилл · 1400 установок
- [technical-writer](https://affpapa.org/nevibecode/skills/technical-writer.md) — скилл · 1000 установок
- [grounded-writing](https://affpapa.org/nevibecode/skills/grounded-writing.md) — скилл · 448 установок

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

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