Grill with Docs: допрос по плану с записью GLOSSARY.md и ADR

mattpocock/skills· Проверено 13.11.2026· 323,4 тыс.на GitHub

Скилл Мэтта Пококка: агент допрашивает вас по плану изменений в репозитории и по ходу записывает согласованные термины в GLOSSARY.md, а трудные решения — в ADR.

Как установить Grill with Docs

Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /grill-with-docs.

# плагином, внутри Claude Code
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock

# или вручную
git clone --depth 1 https://github.com/mattpocock/skills.git /tmp/grill-with-docs
mkdir -p ~/.claude/skills/grill-with-docs
cp -r /tmp/grill-with-docs/skills/engineering/grill-with-docs/. ~/.claude/skills/grill-with-docs/

Что умеет

Допросить вас по плану изменения раундами нумерованных вопросов с готовыми ответами
Записать термин в GLOSSARY.md в момент, когда вы о нём договорились
Оформить ADR в docs/adr/ для решения, которое трудно отменить
Сверить ваши слова с кодом и существующим глоссарием и указать на расхождение
Собрать словарь проекта для репозитория, где документации нет совсем

SKILL.md состоит из одной строки: вызвать скиллы grilling и domain-modeling. Первый ведёт допрос по дереву решений, второй пишет файлы.

Термины попадают в GLOSSARY.md в корне или в глоссарий нужного контекста, если в корне лежит GLOSSARY-MAP.md.

ADR пишется, только когда решение трудно отменить, без контекста оно удивит читателя и за ним стоит реальный выбор между вариантами.

Скилл вызываете вы командой /grill-with-docs: в frontmatter стоит disable-model-invocation: true.

Что нужноСкиллы grilling и domain-modeling из того же репозитория; Рабочая папка с репозиторием, куда агенту можно писать
АгентыРассчитан на Claude Code и Codex: рядом со SKILL.md лежит agents/openai.yaml для Codex.

Что попросить агента

/grill-with-docs Хочу добавить в <сервис> частичную отмену заказаЗадаст раунды вопросов по дереву решений, а согласованные термины сразу запишет в GLOSSARY.md
/grill-with-docs help me document my repoПрочитает код, спросит о найденных понятиях и соберёт глоссарий проекта с нуля
/grill-with-docs make my GLOSSARY.md more concise and remove any implementation details from itВычистит из глоссария детали реализации и оставит только определения терминов

Ограничения

!

Без скиллов grilling и domain-modeling не работает: установка одного grill-with-docs даёт пустую оболочку

!

Большинство решений сессии остаются только в переписке: в файлы идут термины и редкие ADR

!

Внутри чужих оркестраторов и мультиагентных обёрток запись файлов иногда молча пропадает, баг открыт

!

Агент сам скилл не вызывает: нужно набрать /grill-with-docs

Описание из SKILL.md

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Частые вопросы

Как установить grill with docs skill в Claude Code?
Поставьте весь набор: claude plugin install mattpocock-skills@claude-plugins-official. Так вместе с grill-with-docs придут grilling и domain-modeling.
Работает ли grill with docs в Codex?
Да: codex plugin marketplace add mattpocock/skills, затем codex plugin add mattpocock-skills@mattpocock и вызов $grill-with-docs.
Чем grill-with-docs отличается от grill-me?
Допрос тот же. Grill-me подходит для планов без репозитория, grill-with-docs работает в рабочей папке и оставляет на диске GLOSSARY.md и ADR.
Сессия прошла, а GLOSSARY.md и ADR не появились. Почему?
Либо ничего не дотянуло до записи, либо агент не загрузил domain-modeling. Спросите агента, какие скиллы он загрузил, и вызовите недостающий по имени.
Что делать после сессии?
Автор советует в той же переписке вызвать /to-spec, а маленькую правку сразу отдать /implement.
Сколько установок у grill-with-docs?
На skills.sh на 13.11.2026 — 1 322 231 установка, девятое место в общем рейтинге.

Похожие скиллы