# docs-review

Скилл проверяет изменения в markdown-документации на соответствие стайлгайду Metabase и выдаёт нумерованный список замечаний.

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

## Что делает

Скилл включается, когда в дифе меняются файлы `docs/**/*.md`. Он читает изменения целиком, чтобы понять замысел правки, а потом проходит по чек-листу: тон и голос, структура, ссылки, форматирование, примеры кода, построение фраз. Замечания нумеруются по порядку, начиная с Issue 1, чтобы автор мог сослаться на конкретные пункты.

Режимов два. Если доступен инструмент `mcp__github__create_pending_pull_request_review`, скилл работает с пул-реквестом: открывает pending review, собирает все замечания и публикует их одним отзывом через `mcp__github__submit_pending_pull_request_review` с типом события `COMMENT`. Без этого MCP-инструмента замечания просто выводятся в разговор пронумерованным списком.

Внутри скилл опирается на общий файл стайлгайда `_shared/metabase-style-guide.md` и таблицу быстрых совпадений: «click here» вместо описательной ссылки, «easy» и «simple» как снисходительные оценки, «users» вместо «people». Из инструментов ему разрешены `Read`, `Grep`, `Bash` и `Glob`. Для режима пул-реквеста нужен подключённый GitHub MCP-сервер — без него останется только локальный вывод в консоль.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install metabase/metabase docs-review
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add metabase/metabase --skill docs-review -a opencode
```

### Claude.ai

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

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

## Когда брать
- проверить markdown-правки в `docs/` перед мержем
- найти снисходительные формулировки вроде «easy» и «simple»
- заменить «click here» на описательный текст ссылки
- поймать примеры кода, которые не выполнятся
- оставить один отзыв к пул-реквесту вместо россыпи комментариев

## Примеры запросов агенту
- Проверь изменения в документации по стайлгайду Metabase
- Прогони docs-review по дифу в `docs/` и пронумеруй замечания
- Оставь отзыв к пул-реквесту с замечаниями по документации

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

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

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