# docs-voice

Скилл docs-voice для Claude Code переписывает документацию devvm ясным языком, сохраняя факты. Включается при написании и редактировании страниц, README, справки команд и сообщений CLI.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 738 у репозитория
- Автор: devvmhq
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/devvmhq/devvm/tree/HEAD/.agents/skills/docs-voice/SKILL.md
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/devvmhq-docs-voice

## Что делает

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

В комплекте есть `tropes.md` с примерами, `scan.sh` для поиска проблемных фрагментов и `facts.sh` для проверки сохранённых фактов. Для пользовательских страниц с задачами инструкция предлагает начинать с команды или списка шагов; описание механики переносить в раздел How it works, не теряя фактов.

\`scan.sh -p paras FILE` находит последовательности абзацев, а `scan.sh -p long FILE` — длинные абзацы и пункты списка. Порог для длинного фрагмента — больше 80 слов или 4 предложений; `mise run lint:docs` завершает работу с ошибкой при некоторых длинных блоках на пользовательской странице.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add devvmhq/devvm --skill docs-voice -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add devvmhq/devvm --skill docs-voice -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add devvmhq/devvm --skill docs-voice -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install devvmhq/devvm .agents/skills/docs-voice
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add devvmhq/devvm --skill docs-voice -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/devvmhq/devvm --path .agents/skills/docs-voice
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

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

## Примеры запросов агенту
- Перепиши этот README ясным языком, сохрани все факты и команды.
- Отредактируй страницу документации: сначала поставь шаги, затем объяснение.
- Найди сжатые формулировки и шаблонные обороты ИИ в справке CLI.

## Похожие
- [docs-guard](https://affpapa.org/nevibecode/skills/docs-guard.md) — скилл · 4200 установок
- [docs-updater](https://affpapa.org/nevibecode/skills/docs-updater.md) — скилл · 3700 установок
- [update-docs](https://affpapa.org/nevibecode/skills/update-docs.md) — скилл · 1400 установок
- [review-docs](https://affpapa.org/nevibecode/skills/review-docs.md) — скилл · 626 установок
- [docs-starter-kit](https://affpapa.org/nevibecode/skills/docs-starter-kit.md) — скилл · 265 установок
- [absolute-docs](https://affpapa.org/nevibecode/skills/absolute-docs.md) — скилл · 171 установка

## Другие версии с тем же именем
- [docs-voice · reactjs](https://affpapa.org/nevibecode/skills/docs-voice.md) — ★ 11851 у репозитория

Из того же набора: [devvmhq/devvm](https://affpapa.org/nevibecode/by/devvmhq/devvm.md) — 3 карточки

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

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