Skills For Real Engineers: полное руководство по библиотеке навыков для AI-агентов от Matt Pocock

Что такое Skills For Real Engineers

Если коротко: Skills For Real Engineers (репозиторий Matt Pocock Skills) — это библиотека навыков для AI-агентов, созданная Matt Pocock для профессиональных инженеров. Она выросла из его повседневной практики с каталогом .claude.

Позиционирование понятное: это не игрушка для vibe coding, а ежедневный инструментарий для «настоящей инженерии». По словам автора, эти навыки созданы для исправления типичных сбоев, которые он снова и снова встречал у кодинг-агентов вроде Claude Code и Codex.

Чем отличается от GSD и BMAD

GSD, BMAD и Spec-Kit пытаются «взять процесс под контроль». Но вместе с контролем они забирают и вашу свободу: если в процессе что-то ломается, причину трудно найти. Skills For Real Engineers идёт противоположным путём:

• Небольшой, но совершенный: каждый навык работает независимо, без монолитного фреймворка.
• Компонуемый: навыки выбираются по потребности и свободно настраиваются под ваш репозиторий.
• Дорабатываемый (hackable): навыки — это обычные файлы в вашем репозитории; что-то непонятно — правьте.
• Моделенезависимый: нет привязки к конкретной модели, подходят Claude, Codex, Cursor и другие.
• Инженерно-ориентированный: опирается на классические инженерные принципы из «The Pragmatic Programmer» и «Domain-Driven Design», а не на приёмы prompt-инжиниринга.

Позиционирование продукта

Проект рассчитан на разработчиков с реальными инженерными привычками: агент сдерживается настоящей обратной связью — статической типизацией, автоматическими тестами, циклом red-green-refactor, — чтобы не «действовать вслепую». Сама библиотека навыков не предоставляет хостинг и не решает за вас архитектурные вопросы; она предлагает лишь набор переиспользуемых интерфейсов для диалога и рабочих процессов.

Основные функции

Навыки передаются агенту в виде слеш-команд и делятся на несколько групп.

Согласование требований

• /grill-me: интенсивная сессия вопросов перед написанием кода, чтобы полностью согласовать требования и ветви решений; подходит и для задач вне кода.
• /grill-with-docs: то же, что и grilling, но дополнительно формирует общий язык проекта и фиксирует архитектурные решения в ADR.
• /zoom-out: просит агента выйти за пределы локального кода и объяснить ситуацию с точки зрения всей системы.

Разработка и проверка

• /tdd: ведёт агента по циклу red-green-refactor, собирая функциональность или исправляя дефекты по одному вертикальному срезу за раз.
• /diagnose: нормализованный диагностический цикл: воспроизведение → минимизация → гипотеза → инструментирование → исправление → регрессионный тест.
• /prototype: быстро собирает работающий прототип в терминале или несколько вариантов UI, чтобы проверить дизайн.

Задачи и планирование

• /triage: на основе конечного автомата классифицирует и распределяет Issue; поддерживаются собственные метки.
• /to-prd: автоматически собирает контекст текущего диалога в PRD и оформляет его как Issue на GitHub.
• /to-issues: разбивает план или PRD на вертикальные срезы задач, которые можно брать независимо.

Архитектура и совместная работа

• /improve-codebase-architecture: на основе CONTEXT.md и ADR находит возможности углубить модули и борется с разрастанием «big ball of mud».
• /caveman: максимально сжатый режим общения: техническая точность сохраняется, а расход токенов сокращается примерно на 75%.
• /handoff: сжимает текущую сессию в документ передачи дел, чтобы другой агент мог бесшовно продолжить работу.
• /teach: превращает текущий каталог в обучающее пространство с сохранением состояния и объясняет новый навык или концепцию за несколько сессий.
• /write-a-skill: создаёт новый навык по заданной структуре, с постепенным раскрытием деталей и упаковкой ресурсов.

Механизм общего языка

Терминологическая система проекта через CONTEXT.md — приём, который автор ценит в этом наборе больше всего. Наблюдение автора: агента обычно просто «бросают» в проект, и он вынужден угадывать профессиональный жаргон на ходу. В итоге там, где хватило бы одного слова, он использует двадцать.

Пример: вместо «проблема, когда урок внутри раздела курса становится „реальным“ (то есть получает место в файловой системе)» — «проблема с materialization cascade». Одна фраза экономит массу объяснений, и эта экономия умножается от сессии к сессии. Общий язык даёт и другие плюсы: переменные, функции и файлы именуются единообразно; агенту проще ориентироваться в кодовой базе; на размышления агент тратит меньше токенов.

Как использовать Skills For Real Engineers

Есть два пути установки, за которыми стоят две философии. Выбрать нужно только один.

Путь 1: плагин для Claude Code

• Весь набор ставится как управляемый read-only пакет: автор выпускает обновление — оно приходит автоматически. Это скорее «подписка», чем fork.
• Плагин уже есть в официальном маркетплейсе Claude Code: источник добавлять не нужно, обновления приходят автоматически.
• Нативный плагин для Codex — в дорожной карте (см. .agents/adr/0002-ship-as-a-claude-code-plugin.md).

Путь 2: установщик skills

Запустите npx skills@latest add mattpocock/skills, выберите целевого агента и отметьте /setup-matt-pocock-skills. Установщик позволяет самому выбрать, какие навыки взять и на какие кодинг-агенты их установить. Навыки записываются в ваш репозиторий как обычные файлы: вы ими владеете и можете править, ничего не обновляется «за вашей спиной». Когда захотите свежие изменения, подтяните их командой npx skills update.

Важно: если установить оба способа сразу, каждый навык появится в двух экземплярах.

Инициализация и ежедневный ритм работы

1. Выполните /setup-matt-pocock-skills в агенте (один раз на репозиторий). Он спросит: какой Issue-трекер использовать (GitHub, Linear или локальные файлы); какие метки вы вешаете на задачи при триаже (/triage опирается на эти метки); куда сохранять создаваемые документы.
2. Перед каждым изменением согласовывайте требования через /grill-me или /grill-with-docs.
3. Во время разработки держите качество с помощью /tdd.
4. При баге запускайте /diagnose и проходите нормализованную диагностику.
5. Для здоровья архитектуры регулярно запускайте /improve-codebase-architecture, чтобы код не «гнил».

Установка и настройка занимают около 30 секунд. В качестве Issue-трекера поддерживаются GitHub, Linear или локальные файлы.

Сценарии применения

• Согласование требований и планирование: перед стартом проекта или изменением функциональности проведите с агентом интенсивную сессию вопросов через /grill-me или /grill-with-docs, чтобы полностью согласовать требования, ветви решений и термины предметной области.
• Разработка через тестирование: когда качество кода критично, используйте /tdd, чтобы агент вёл цикл red-green-refactor и собирал функциональность или исправлял дефекты вертикальными срезами, — каждое изменение будет под защитой автоматических тестов.
• Диагностика сложных багов: при трудно воспроизводимых регрессиях производительности или логических дефектах запускайте /diagnose и пройдите весь диагностический цикл.
• Постоянное управление архитектурой: в крупных долгоживущих кодовых базах регулярно запускайте /improve-codebase-architecture — он на основе CONTEXT.md и ADR ищет возможности углубить модули и не даёт агенту ускорять деградацию кода.
• Совместная работа между сессиями: /handoff сжимает сессию в компактный документ, /caveman снижает расход токенов — полезно для длинных задач и эстафеты между людьми и агентами.

Преимущества

• Лёгкий и компонуемый: без тяжёлых фреймворков, каждый навык работает независимо и свободно адаптируется.
• Моделенезависимый: работает с Claude, Codex, Cursor и другими.
• Инженерная основа: строится на классических инженерных принципах, а не на prompt-приёмах.
• Механизм общего языка: CONTEXT.md заметно снижает затраты на общение с агентом и расход токенов.
• Замкнутая обратная связь: упор на реальную обратную связь — статическую типизацию, автоматические тесты, red-green-refactor.
• Простота доработки: при установке через skills навыки лежат в вашем репозитории как редактируемые файлы.

Ограничения

• Это набор навыков, а не сквозной менеджер процессов: командам без общего языка и дисциплины ADR придётся самостоятельно вести CONTEXT.md и записи решений.
• Система меток /triage зависит от настроек при инициализации: при неудачной конфигурации пострадает качество триажа.
• Два пути установки взаимоисключающие: смешанная установка даст дубликаты навыков.
• Нативный плагин для Codex пока в дорожной карте; пользователям Codex сейчас доступен путь установки файлов навыков.
• Точный объём поддержки, детали команд и ритм обновлений могут меняться.

Проверка цены и доступности

В фактах, предоставленных для этой статьи, нет данных о цене, платной подписке или условиях лицензирования, поэтому мы не делаем предположений. Платный ли это продукт, какова лицензия, какие каналы установки доступны и какая версия актуальна, — проверяйте на официальном сайте https://github.com/mattpocock/skills и на странице официального маркетплейса вашего агента перед принятием решения.

Часто задаваемые вопросы (FAQ)

Привязан ли проект к конкретной модели?

Нет. Официально он модельнезависим: подходят Claude, Codex, Cursor и другие.

Можно ли работать сразу после установки?

Сначала нужна инициализация. Выполните в агенте /setup-matt-pocock-skills и настройте Issue-трекер, метки триажа и каталог для документов. После этого такие навыки, как /triage, заработают по вашим правилам.

Что выбрать: плагин или установщик?

Если хотите получать обновления автора и согласны на управляемый read-only пакет — берите плагин для Claude Code. Если хотите владеть файлами, дорабатывать их и сами контролировать момент обновления — используйте npx skills@latest add mattpocock/skills. Не ставьте оба варианта одновременно.

Конфликтует ли он с GSD и BMAD?

По замыслу автора это альтернативный подход: GSD, BMAD и Spec-Kit помогают, беря процесс под контроль, но тем самым забирают контроль у вас и мешают решать проблемы внутри процесса. Этот набор навыков выбирает путь «небольшой, но совершенный», компонуемый и дорабатываемый. Смешивать ли подходы — вопрос дисциплины вашей команды.

Какой навык стоит попробовать первым?

Автор считает, что /grill-with-docs — возможно, самый сильный приём во всём репозитории: это и сессия интенсивных вопросов, и способ выстроить общий язык с ИИ, и фиксация труднообъяснимых решений в ADR.

Альтернативы

• GSD, BMAD, Spec-Kit: тяжёлые фреймворки, которые пытаются взять процесс разработки под контроль; у вас меньше контроля, а проблемы в процессе находить труднее.
• Agent Skill с открытым исходным кодом от Eze (一泽): сфокусирован на том, как агенту «думать о выходе в интернет».
• Плагин с открытым исходным кодом от Jesse Vincent: агентный фреймворк навыков и методология разработки ПО.
• Открытый AI design Skill, созданный специально для AI-ассистентов по написанию кода.
• Универсальный вариант: вести собственный набор файлов навыков в .claude или на уровне проекта и собирать их под привычки команды.

Первоисточники

• Официальный сайт и репозиторий: https://github.com/mattpocock/skills

Если хотите следить за изменениями этих навыков и новыми навыками автора, подпишитесь на его newsletter — его читают около 60 000 разработчиков.