При работе с кодинг-агентами (Claude Code, OpenAI Codex, Cursor, OpenClaw) разработчики часто сталкиваются с одной и той же проблемой: агент начинает писать код без плана, пропускает тесты, накапливает ошибки и быстро забивает контекстное окно. В итоге приходится либо постоянно переписывать промпты вручную, либо вручную исправлять последствия.
Репозиторий mattpocock/skills от Мэтта Покока (создателя Total TypeScript) — это библиотека скилов, которую автор скопировал напрямую из своей рабочей папки .agents/skills/. Навыки оформлены по открытому стандарту Agent Skills и определяют точный порядок действий агента на каждом шаге разработки.
Что такое Agent Skills
Формат Agent Skills — это открытый стандарт расширения возможностей AI-агентов. Каждый скил представляет собой директорию с файлом SKILL.md, где прописаны правила вызова, ограничения и пошаговые инструкции. Когда скил подключен к проекту, кодинг-агент читает его и выполняет задачу строго по заданному сценарию.
Пайплайн разработки: от постановки задачи до проверки
Скилы в репозитории выстроены в цепочку, которая закрывает типовые этапы работы с кодовой базой:
| Этап | Скил | Что делает агент | Результат |
|---|---|---|---|
| 1. Уточнение задачи | grill-with-docs |
Задаёт разработчику вопросы по задаче и спорным моментам перед написанием кода | Фиксирует архитектурные решения (ADR в docs/adr/) и словарь терминов (GLOSSARY.md) |
| 2. Декомпозиция | to-tickets |
Разбивает задачу на граф независимых тикетов с зависимостями | Создаёт файлы задач в .scratch/ или заводит тикеты в GitHub Issues / Linear |
| 3. Написание кода | implement + tdd |
Берёт один тикет за раз. Сначала пишет падающий тест, затем код реализации | Чистый цикл TDD. Между тикетами сбрасывается контекст через /clear |
| 4. Проверка | code-review |
Запускает двух субагентов для параллельной проверки изменений | Один субагент проверяет соответствие ТЗ, второй — правила оформления кода в проекте |
Категории скилов: разделение прав вызова
Все скилы в репозитории разделены на две группы по способу вызова:
1. Скилы, вызываемые пользователем (User-invoked)
В файле манифеста этих скилов указан флаг disable-model-invocation: true (или policy.allow_implicit_invocation: false для Codex). Агент не может запустить их самостоятельно — вызов происходит только по прямому указанию разработчика:
ask-matt: скил-навигатор. Анализирует текущую задачу и подсказывает, какой скил из набора лучше применить.improve-codebase-architecture: анализ кодовой базы. Просматривает историю коммитов (git log), находит перегруженные модули и формирует интерактивный HTML-отчёт с вариантами рефакторинга.wayfinder: планирование крупных задач, которые не помещаются в рамки одной рабочей сессии агента.retro: разбор сессии. Анализирует сложности, возникшие во время работы, и предлагает правки для инструкций проекта (AGENTS.md) и настроек линтера.
2. Автоматические скилы агента (Model-invoked)
Эти навыки агент подключает сам по мере необходимости во время написания кода:
tdd: обязывает агента воспроизвести проблему тестом до изменения файлов проекта.diagnosing-bugs: алгоритм поиска ошибок: сбор фактов, формулирование гипотез и создание минимального воспроизводимого примера (repro).codebase-design: правила структурирования модулей и построения интерфейсов.
Установка и подключение
Репозиторий поддерживает два способа установки в зависимости от используемого инструмента:
Способ 1. Установка через открытый CLI npx skills (для любых агентов)
Команда для добавления скилов в проект:
npx skills@latest add mattpocock/skillsИнтерактивное меню позволяет выбрать нужные скилы и целевых агентов (Codex, Cursor, OpenClaw, Claude Code). Исходные файлы сохраняются в директорию .agents/skills/ внутри проекта.
Способ 2. Установка в Claude Code как плагин
Для пользователей Claude Code доступна установка из официального каталога плагинов:
claude plugins install mattpocock-skills
# или в окне сессии:
/plugin install mattpocock-skillsНастройка структуры проекта
После добавления файлов выполняется первичная настройка каталогов:
run setup-matt-pocock-skillsСкил создаёт папки для архитектурных решений (docs/adr/), файл словаря GLOSSARY.md и настраивает метки для задач.
Пример работы со скилами
- Разработчик описывает идею фичи и запускает скил
grill-with-docs. Агент задаёт уточняющие вопросы и фиксирует структуру в ADR. - Скил
to-ticketsделит задачу на отдельные тикеты с указанием зависимостей. - Скил
implementберёт первый тикет, подключаетtdd, пишет тест и затем реализует функциональность. - Перед сохранением изменений скил
code-reviewзапускает двух субагентов для проверки кода.
Итог
mattpocock/skills — практичный набор готовых скилов по открытому стандарту Agent Skills. Он заменяет длинные промпты чёткими сценариями работы: уточнение деталей через интервью, фиксация архитектуры, декомпозиция на тикеты, TDD и перекрёстная проверка субагентами.
