Skills for Real Engineers from Matt Pocock — навыки для AI-агентов от Мэтта Покока

Мэтт Покок — тот самый человек, который стоит за Total TypeScript. Его проект Skills for Real Engineers с момента нашего первого обзора вырос почти вдвое: со 117 до 223 тысяч звёзд на GitHub. Но главное даже не в цифрах — коллекция серьёзно переработана: изменилась установка, появилась новая таксономия навыков и целый ряд мощных новинок.

Идея прежняя: вместо того чтобы отдавать контроль процессу (как GSD, BMAD или Spec-Kit), Мэтт предлагает маленькие компонуемые кирпичики, из которых вы сами собираете рабочий процесс. Работает с любой моделью — Claude Code, Codex и любым другим агентом.

Установка: теперь два способа

Раньше всё ставилось одной командой. Теперь два пути — и две философии.

Claude Code плагин — весь набор как управляемый read-only бандл из официального маркетплейса. Обновления прилетают автоматически, вы подписаны, а не форкнули:

claude plugins install mattpocock-skills

skills.sh — копирует редактируемые файлы навыков прямо в ваш проект. Вы владеете файлами, никто ничего не обновляет за вашей спиной; свежие изменения тянете командой npx skills update:

npx skills@latest add mattpocock/skills

Выбирайте что-то одно: при установке обоих способов каждый навык окажется в проекте дважды.

После установки запустите /setup-matt-pocock-skills — он спросит, какой трекер задач использовать (GitHub, Linear или локальные файлы), какие лейблы вы применяете при триадже и куда сохранять документы.

Новая таксономия: кто вызывает навык

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

• User-invoked — запускаются только вами (например, /grill-me). Их работа — оркестрация
• Model-invoked — агент может взять их сам, когда задача подходит. В них живёт переиспользуемая дисциплина

Правило простое: user-invoked навык может вызывать model-invoked, но никогда — другой user-invoked. Своеобразное разделение на команды и библиотечные функции.

Четыре проблемы — актуальный арсенал

Проблема №1: Агент сделал не то, что вы хотели

Классика: вы думаете, что понятно объяснили задачу, агент кивает и пишет код — а результат оказывается про другое. Решение — гриллинг-сессии. Перед написанием кода агент засыпает вас вопросами, пока не станет кристально ясно, что именно вы хотите:

• /grill-me — для общего использования, не только для кода
• /grill-with-docs — то же самое, плюс выстраивание общего языка проекта и документирование сложных решений в ADR

Это самые популярные навыки репозитория. Мэтт рекомендует использовать их при каждом изменении.

Проблема №2: Агент говорит слишком много

Причина — нет общего языка: агент не знает терминологии проекта и объясняет простые вещи сложными словами. Решение — документ CONTEXT.md. Пример из репозитория course-video-manager: «проблема, когда урок внутри секции курса становится "настоящим" (получает место в файловой системе)» превращается в «проблему с каскадом материализации». Одно слово вместо десяти — и так сессия за сессией.

Новинка: /domain-modeling — агент активно строит и заостряет доменную модель: проверяет термины против глоссария, тестирует их граничными сценариями и обновляет CONTEXT.md и ADR на лету.

Проблема №3: Код не работает

Вы согласны, что строить, — но код всё равно плохой. Причина — отсутствие обратной связи. Решения:

• /tdd — классический red-green-refactor: сначала падающий тест, потом минимальный код. Фичи строятся вертикальными срезами
• /diagnosing-bugs — дисциплинированный цикл отладки (бывший /diagnose): петля фидбека, красная на этом баге → минимизация → гипотеза → инструментирование → исправление → регрессионный тест

Проблема №4: Получился комок грязи

Агенты ускоряют написание кода — и заодно его энтропию. Решения:

• /to-spec (бывший /to-prd) — перед созданием спеки спрашивает, какие модули вы собираетесь затронуть
• /improve-codebase-architecture — теперь не просто ищет точки улучшения, а строит визуальный HTML-отчёт и прогоняет через гриллинг выбранный вами вариант. Мэтт рекомендует запускать раз в несколько дней. Важная оговорка: это обзор, а не спасательная операция — по-настоящему старый комок грязи он за вас не распутает

Флагманские новинки

/implement — полноценный конвейер сборки: берёт спеку или набор тикетов, ведёт разработку через /tdd в заранее согласованных точках и завершает /code-review перед коммитом.

/wayfinder — для работы размером больше одной сессии агента: строит на трекере задач общую карту из решающих тикетов и закрывает их по одному, пока путь к цели не станет ясен.

/code-review — ревью по двум осям: Standards (стандарты репозитория плюс бейзлайн код-смелсов Фаулера) и Spec (точно ли диф реализует исходную задачу). Осями занимаются параллельные сабагенты, чтобы не загрязнять контекст друг друга.

/research — фоновый агент исследует вопрос по доверенным первоисточникам и сохраняет результат как Markdown-файл со ссылками прямо в репозиторий.

/resolving-merge-conflicts — разбирает конфликт ханк за ханком, восстанавливая намерение каждой стороны по её первоисточнику. Сдаваться через --abort запрещено.

/wizard — генерирует интерактивный bash-визард для шагов, которые может выполнить только человек: провижининг инфраструктуры, настройка секретов CI, незнакомые сторонние дашборды.

Из продуктивности: /teach (обучение новому навыку за несколько сессий с рабочей директорией), /to-questionnaire (Markdown-анкета для единственного человека, который знает ответ), /wait-what (когда сообщение агента не зашло — он пересказывает его обычным языком с недостающим контекстом) и /ask-matt (роутер: подскажет, какой навык подходит под вашу ситуацию).

Полный список навыков

Engineering — user-invoked

Engineering — model-invoked

Productivity

Кстати, часть старых навыков переехала: /diagnose стал /diagnosing-bugs, /to-prd — /to-spec, /to-issues — /to-tickets. А /caveman, /zoom-out и /write-a-skill коллекцию покинули.

Почему это работает

Философия не изменилась: Мэтт не забирает контроль у разработчика и не строит «процесс», которому нужно следовать. Он даёт маленькие инструменты, основанные на классических принципах — прагматичное программирование, domain-driven design, экстремальное программирование, — упакованные в форму, понятную AI-агентам.

Разница в том, что из набора разрозненных команд коллекция выросла в систему с собственной архитектурой: оркестрация сверху, дисциплина снизу, и всё это компониется как угодно вам. Следить за новинками можно через рассылку Мэтта — там уже около 60 тысяч разработчиков.

Если вы устали от того, что агент делает не то, болтает лишнего и превращает проект в кашу — начните с /grill-me или /grill-with-docs. А если проект уже большой — с /improve-codebase-architecture и новенького /implement.