Improve Codebase Architecture: скилл Мэтта Пококка для углубления модулей

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

Скилл Мэтта Пококка: агент ищет в кодовой базе мелкие модули, которые стоит углубить, показывает кандидатов в HTML-отчёте и разбирает с вами выбранного.

Как установить Improve Codebase Architecture

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

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

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

Общая папка ~/.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/improve-codebase-architecture
mkdir -p ~/.agents/skills/improve-codebase-architecture
cp -r /tmp/improve-codebase-architecture/skills/engineering/improve-codebase-architecture/. ~/.agents/skills/improve-codebase-architecture/

Установщик скиллов от Vercel, нужен Node.js 22.20 или новее. Без -g скилл ставится в текущий проект; флаг -a выбирает агента.

npx skills add mattpocock/skills --skill improve-codebase-architecture -a claude-code

# для всех проектов
npx skills add mattpocock/skills --skill improve-codebase-architecture -g

Нужен тариф Pro, Max, Team или 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

Что умеет

Найти горячие точки по истории коммитов или в указанной вами области

Проверить подозрительный модуль тестом удаления: сконцентрирует ли удаление сложность

Собрать HTML-отчёт: карточка на кандидата с файлами, проблемой, решением, схемой до и после и оценкой Strong, Worth exploring или Speculative

Разобрать выбранного кандидата допросом по дереву решений

Дописать термины в GLOSSARY.md и предложить ADR, если вы отклонили кандидата по веской причине

Обход кода делает субагент со свежим контекстом; агент заранее читает GLOSSARY.md и ADR в docs/adr/.

Отчёт — один HTML-файл architecture-review-<время>.html во временной папке ОС на Tailwind и Mermaid с CDN; агент открывает его и называет путь.

Словарь архитектуры (модуль, интерфейс, глубина, шов, адаптер) берётся из скилла codebase-design, допрос — из grilling, словарь проекта ведёт domain-modeling.

Код скилл не меняет: после отчёта он спрашивает, какого кандидата разобрать.

Что нужноСкиллы codebase-design, grilling и domain-modeling из того же репозитория; Доступ к сети при открытии отчёта: Tailwind и Mermaid грузятся с CDN

АгентыРассчитан на Claude Code и Codex: рядом со SKILL.md лежит agents/openai.yaml для Codex.

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

/improve-codebase-architectureНайдёт горячие точки по git log, соберёт HTML-отчёт с кандидатами и спросит, какого разобрать

/improve-codebase-architecture Как сделать изменение из <docs/spec.md> простым?Сосредоточится на модулях, которые затронет спецификация, и предложит углубления под неё

/improve-codebase-architecture Не допрашивай, покажи только отчётСоберёт отчёт с кандидатами и остановится

Ограничения

Агент сам скилл не вызывает: нужно набрать /improve-codebase-architecture

Почти всегда находит кандидатов; если все помечены Speculative, значит, ничего не нашёл

Без доступа к CDN отчёт открывается без стилей и схем

Допрос по кандидату может затянуться; чтобы получить только отчёт, скажите об этом при вызове

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

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

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

Как установить improve-codebase-architecture skill от Мэтта Пококка?

В Claude Code одной командой: claude plugin install mattpocock-skills@claude-plugins-official, ставится весь набор. В Cursor, OpenCode, Windsurf и других агентах: npx skills@latest add mattpocock/skills -a <агент>.

Меняет ли improve-codebase-architecture код?

Нет. За запуск появляется HTML-отчёт во временной папке и правки GLOSSARY.md, если вы их приняли. Рефакторинг делается потом, в отдельной сессии.

Можно без допроса, только отчёт?

Да, скажите об этом при вызове: «не допрашивай, покажи отчёт».

Как часто запускать?

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

Сколько кандидатов разбирать за сессию?

Одного. Иначе окно контекста заполнят отчёт, допрос, правки словаря и код одновременно.

Как его лучше запускать?

С ближайшей задачей: укажите спецификацию и спросите «как сделать это изменение простым?». Без подсказки скилл сам ищет горячие точки.