
Domain Modeling: скилл для словаря проекта и записей решений
Скилл Мэтта Пококка для словаря проекта: агент ловит размытые и спорные термины, сверяет их с кодом и записывает в GLOSSARY.md, а трудные решения — в ADR.
Как установить Domain Modeling
Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /domain-modeling.
# плагином, внутри Claude Code
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocock
# или вручную
git clone --depth 1 https://github.com/mattpocock/skills.git /tmp/domain-modeling
mkdir -p ~/.claude/skills/domain-modeling
cp -r /tmp/domain-modeling/skills/engineering/domain-modeling/. ~/.claude/skills/domain-modeling/Общая папка ~/.agents/skills/ (в проекте — .agents/skills/) читают Codex, Cursor, VS Code Copilot, Gemini CLI, Antigravity, OpenCode, Kilo Code, Goose, Qwen Code.
git clone --depth 1 https://github.com/mattpocock/skills.git /tmp/domain-modeling
mkdir -p ~/.agents/skills/domain-modeling
cp -r /tmp/domain-modeling/skills/engineering/domain-modeling/. ~/.agents/skills/domain-modeling/Установщик скиллов от Vercel, нужен Node.js 22.20 или новее. Без -g скилл ставится в текущий проект; флаг -a выбирает агента.
npx skills add mattpocock/skills --skill domain-modeling -a claude-code
# для всех проектов
npx skills add mattpocock/skills --skill domain-modeling -gСвои скиллы загружают на любом тарифе, от Free до Enterprise; нужно включённое выполнение кода.
Скачайте папку скилла с GitHub и упакуйте её в ZIP.
claude.ai → Customize → Skills → + → Create skill → Upload a skill
Загрузите ZIP и включите скилл переключателем.Gemini CLI ставит скиллы из git-репозитория и хранит их в ~/.gemini/skills/.
gemini skills install https://github.com/mattpocock/skills.git --consent
# проверка
gemini skills listЧто умеет
Файлы создаются по мере надобности: GLOSSARY.md при первом термине, docs/adr/ при первом ADR. Если в корне есть GLOSSARY-MAP.md, у каждого контекста свой глоссарий.
Термин описывает, что это такое, в одной-двух фразах; отвергнутые синонимы идут под _Avoid_. Форматы — в GLOSSARY-FORMAT.md и ADR-FORMAT.md.
ADR пишется, только когда решение трудно отменить, без контекста оно удивит и за ним стоит реальный выбор. Не прошло хоть одну проверку — ADR нет.
Агент вызывает скилл сам; чаще он работает внутри grill-with-docs, triage, wayfinder и improve-codebase-architecture.
Что попросить агента
Ограничения
Модели склонны превращать GLOSSARY.md в спецификацию с деталями реализации, это самая частая жалоба
Сверяет термины только с кодом, глоссарием и ADR: решения из закрытых issue скилл не видит
Формат и место ADR зашиты в скилл, свой шаблон ADR без правки скилла не подключить
Внутри grill-with-docs модели часто загружают только grilling и пропускают этот скилл
Описание из SKILL.md
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.