# write-manual

Скилл для написания длинного технического руководства об одной системе на зафиксированной версии — от назначения до каждого запроса и ответа.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 484 установки · ★ 73982
- Автор: rohitg00
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/rohitg00/ai-engineering-from-scratch/tree/HEAD/skills/write-manual/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/write-manual

## Что делает

Скилл задаёт полный метод: исследование, ранжированные источники, реестр конфликтов между ними, набор офлайн-захватов, фиксированная форма разделов, лимиты прозы и аудит, который обязан выдать `TOTAL 0`. Работает в любом репозитории. Внутри репозитория AI Engineering from Scratch инструменты уже есть, а `manuals/a2a-101/` — готовый пример.

Метод разложен на 13 шагов: зафиксировать версию, URL источника, коммит, дату релиза и дату проверки; расставить источники по авторитету; скопировать то, что разрешает лицензия; написать факт-бриф; открыть реестр конфликтов; собрать набор захватов; спланировать содержание по спецификации; заполнить `manual.json`; написать front matter; писать по одному разделу за раз; нарисовать фигуры из захватов; собрать и прогнать аудит до `TOTAL 0`.

Ориентир по объёму: 60–100 страниц, 6–8 частей плюс справочная, около 25 разделов, 30–40 фигур. Каждый раздел держит одну тезу не длиннее 30 слов, одно предложение «When you finish this section, you can ...» в первых двух абзацах и ровно один блок `takeaways` минимум с двумя пунктами. Без офлайн-захватов руководство превращается в эссе — если систему нельзя запустить и записать её вывод, метод не сработает.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rohitg00/ai-engineering-from-scratch --skill write-manual -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rohitg00/ai-engineering-from-scratch --skill write-manual -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rohitg00/ai-engineering-from-scratch --skill write-manual -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rohitg00/ai-engineering-from-scratch write-manual
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rohitg00/ai-engineering-from-scratch --skill write-manual -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/rohitg00/ai-engineering-from-scratch --path skills/write-manual
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add rohitg00/ai-engineering-from-scratch --skill write-manual -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/rohitg00/ai-engineering-from-scratch/tree/HEAD/skills/write-manual/SKILL.md

## Когда брать
- описать одну систему на зафиксированной версии так, чтобы читатель предсказывал её поведение
- свести источники в порядок по авторитету и пометить расхождения между ними
- записать офлайн-захваты запросов и ответов в детерминированные файлы
- собрать `manual.json` с версией, результатами обучения, палитрой и частями
- прогнать аудит и починить находки до `TOTAL 0`

## Примеры запросов агенту
- Напиши руководство по протоколу A2A на версии из коммита, начни с `manual.json`
- Добавь раздел про CancelTask и терминальные состояния в `manuals/a2a-101/`
- Собери набор захватов для этого протокола и вырежи листинги из файлов в `capture/out/`

## Похожие
- [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 установка

Из того же набора: [rohitg00/ai-engineering-from-scratch](https://affpapa.org/nevibecode/by/rohitg00/ai-engineering-from-scratch.md) — 16 карточек

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