# update-docs

Скилл update-docs для Claude Code сверяет документацию Rerun с изменениями в коде. Запускается перед завершением работы или созданием PR, если затронуты указанные части проекта, а также по просьбе обновить документацию.

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

## Что делает

Скилл анализирует diff ветки и находит страницы сайта `apps/docs`, README и файлы в `apps/engine/docs`, которые стали неверными, устарели или не описывают новые изменения. Он добавляет, правит или удаляет их в том же pull request, что и код; числа берёт из кода. Если diff затрагивает только внутренние переименования, тесты или рефакторинг, скилл предлагает сообщить в PR, что правки документации не нужны.

Для новых страниц он требует добавить запись в `apps/docs/docs.json`, а удалённым назначить перенаправление. Перед проверкой документации нужно спросить, где запускать `pnpm check:docs`; видимые страницы можно открыть через `pnpm dev:docs` по адресу `http://localhost:3333`. Сайт публикуется из `master`, поэтому скилл ориентирует текст на изменения ветки, а не текущую production-версию.

## Требования
- Работает с: Supabase, Docker

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rerun-build/rerun --skill update-docs -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rerun-build/rerun --skill update-docs -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rerun-build/rerun .claude/skills/update-docs
```

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

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini skills install https://github.com/rerun-build/rerun --path .claude/skills/update-docs
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

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

## Примеры запросов агенту
- Обнови документацию по изменениям в `apps/ui` перед созданием PR.
- Проверь, актуальна ли документация после изменений в `docker-compose.yml`.
- Сверь документацию Rerun с diff ветки и перечисли изменённые страницы.

## Похожие
- [skillshare-update-docs](https://affpapa.org/nevibecode/skills/skillshare-update-docs.md) — скилл · ★ 3269 у репозитория
- [update-project-docs](https://affpapa.org/nevibecode/skills/update-project-docs.md) — скилл · ★ 1198 у репозитория
- [update-docs-on-code-change](https://affpapa.org/nevibecode/rules/update-docs-on-code-change.md) — правило · ★ 41430 у репозитория
- [docker-docs](https://affpapa.org/nevibecode/skills/docker-docs.md) — скилл · 623 установки
- [gsd-docs-update](https://affpapa.org/nevibecode/skills/gsd-docs-update.md) — скилл · 576 установок
- [dev-docs-update](https://affpapa.org/nevibecode/commands/dev-docs-update.md) — команда · ★ 10055 у репозитория

## Другие версии с тем же именем
- [update-docs · neolabhq](https://affpapa.org/nevibecode/skills/update-docs.md) — 1400 установок
- [update-docs · alexj11324](https://affpapa.org/nevibecode/skills/alexj11324-update-docs.md) — ★ 88 у репозитория

Из того же набора: [rerun-build/rerun](https://affpapa.org/nevibecode/by/rerun-build/rerun.md) — 25 карточек

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