Позиция репозитория — намеренная компактность и модульность. Он не пытается заменить инженерный процесс гигантским агентским фреймворком. Он прививает агентам лучшие привычки для тех этапов разработки ПО, где чаще всего возникают сбои: неопределенность, циклы обратной связи, предметная область, архитектурный дрейф, тестирование и качество передачи дел.
Get the latest on AI, LLMs & developer tools
New MCP servers, model updates, and guides like this one — delivered weekly.
Редакционная заметка
Эта статья основана на GitHub репозитории, README, файлах навыков, скриптах настройки, документации, текущих issue и PR, списке skills.sh, ссылке на рассылку и публичных метаданных GitHub, собранных 2 июня 2026 года. Точные счетчики популярности опущены, так как они быстро меняются.
1. skills в одном предложении
Репозиторий `skills` от Matt Pocock — это набор небольших, адаптируемых навыков рабочего процесса AI-агента с лицензией MIT для реальных задач разработки ПО, таких как TDD, диагностика, уточнение продукта, документирование, улучшение архитектуры, приоритизация задач и передача дел.
| Область | Детали | Почему это важно |
|---|---|---|
| Репозиторий | mattpocock/skills | https://github.com/mattpocock/skills |
| Основной язык | Shell | Основной язык GitHub на момент исследования. |
| Лицензия | MIT | При необходимости отдельно проверьте лицензии встроенных или бинарных компонентов. |
| Создано | 3 февраля 2026 г. | Во время исследования релизы GitHub не найдены; основная ветка и issues активны. |
2. Почему это важно
Этот репозиторий важен, потому что многие сбои при написании кода с помощью AI — это сбои процессов. Агент неправильно понимает запрос, меняет слишком много за раз, не имеет обратной связи, игнорирует язык предметной области или создает код, который сложно поддерживать.
Вместо одной огромной методологии эти навыки представляют собой узкоспециализированные инструменты. Вы можете запустить `/grill-with-docs` перед реализацией функции, `/tdd` во время реализации, `/diagnose` при работе с багом, `/improve-codebase-architecture` после накопления энтропии и `/handoff` при необходимости передачи контекста.
Инженерный подход также примечателен: README отвергает расплывчатое «vibe coding» и подчеркивает фундаментальные основы, такие как общий язык, red-green-refactor, маленькие шаги, обратная связь, глубокие модули и ответственное проектирование.
3. Архитектура и ментальная модель
Репозиторий организован по категориям навыков: инженерия, продуктивность, разное, личное, в процессе разработки и устаревшие. Небольшой навык настройки записывает конфигурацию для каждого репозитория, такую как трекер задач, метки приоритизации и расположение документации, чтобы другие навыки могли работать согласованно.
| Область | Детали | Почему это важно |
|---|---|---|
| Установщик | `npx skills@latest add mattpocock/skills` | Основной путь настройки README через skills.sh. |
| Настройка навыка | `setup-matt-pocock-skills` | Фиксирует трекер задач, метки и расположения документации, используемые другими навыками. |
| Планирование | `grill-with-docs`, `grill-me`, `to-prd`, `to-issues` | Уточняет намерения, предметные термины, решения, PRD и фрагменты задач. |
| Реализация | `tdd`, `diagnose`, `prototype` | Улучшает циклы обратной связи, дисциплину отладки и исследовательское проектирование. |
| Архитектура | `improve-codebase-architecture`, `zoom-out` | Находит проектное давление, возможности для углубления и более широкий контекст кода. |
| Операции | `triage`, `handoff`, `git-guardrails-claude-code`, `setup-pre-commit` | Поддерживает состояние задач, передачу контекста и более безопасные рабочие процессы в репозитории. |
| Документация | Форматы `CONTEXT.md`, `docs/adr/`, `grill-with-docs` | Общий язык и записи о принятых архитектурных решениях являются первоклассными объектами. |
| Скрипты | `scripts/link-skills.sh`, `scripts/list-skills.sh` | Локальные помощники оболочки для перечисления и связывания навыков. |
4. Минимальная end-to-end настройка
Команды ниже взяты из документации репозитория и сверены с текущим исследовательским снимком. Используйте их как отправную точку, а затем прочитайте связанную README перед установкой в production.
# Install through skills.sh
npx skills@latest add mattpocock/skills
# In your agent, select the skills you want.
# Include setup-matt-pocock-skills.
# Then run the setup skill once per repository:
/setup-matt-pocock-skillsНебольшая первая задача должна подтвердить интеграцию, прежде чем подключать ее к критичным данным или большим рабочим пространствам.
# Clarify a feature and update docs/ADRs
/grill-with-docs
# Build the change with a red-green-refactor loop
/tdd
# Diagnose a hard bug
/diagnose
# Break a plan into independently grabbable issues
/to-issues
# Hand off a session to another agent or future context
/handoff5. Технический разбор
5.1 Навык настройки — это тихая зависимость
В README сказано выбрать `/setup-matt-pocock-skills` во время установки и запустить его перед остальным инженерным рабочим процессом. Это не пустая работа. Он записывает выбор трекера задач, метки сортировки и расположение документации, чтобы такие навыки, как `to-issues`, `triage` и `grill-with-docs`, могли работать предсказуемо.
Текущие проблемы даже обсуждают границы политики настройки. Это говорит нам о том, что репозиторий заботится о повторяемости, а не оставляет каждый навык на самостоятельное обнаружение локальных соглашений.
5.2 Grilling — это инструмент формирования требований
`grill-me` и `grill-with-docs` построены на простом наблюдении: пользователи часто не знают точно, чего они хотят, пока им не зададут вопросы. Этот навык заставляет агента задавать конкретные вопросы перед написанием кода.
`grill-with-docs` расширяет это до общего языка и ADR. Это особенно полезно в реальных продуктах, поскольку доменные термины сокращают многословные объяснения и улучшают имена, тесты и заголовки задач.
before coding:
ask hard questions
define domain terms
record decisions
narrow scope
then implement5.3 TDD и диагностика создают циклы обратной связи
`/tdd` подталкивает агентов к red-green-refactor и меньшим вертикальным срезам. `/diagnose` подталкивает к воспроизведению, минимизации, выдвижению гипотез, инструментированию, исправлению и регрессионному тестированию.
Эти навыки сами по себе не делают модель умнее. Они меняют цикл взаимодействия с моделью, чтобы она получала более качественные данные перед внесением правок и лучше проверяла результат после них.
5.4 Работа с архитектурой рассматривается как ответственное проектирование.
`improve-codebase-architecture` предназначен для кодовых баз, которые становится сложно изменять. В README он связывается с такими идеями, как глубокие модули, предметно-ориентированный язык и ежедневные инвестиции в проектирование.
Это правильный уровень амбиций для навыка агента: не «переписать приложение», а проанализировать нагрузку на дизайн, уточнить интерфейсы и создать конкретные возможности для углубления архитектуры.
5.5 Репозиторий намеренно не является монолитом.
Навыки достаточно малы, чтобы их можно было адаптировать. Это важно, поскольку у команд разные системы отслеживания задач, соглашения по документации, инструменты тестирования, предметно-ориентированные языки и уровень допустимой автономности агента.
Текущая поверхность PR и задач показывает, что границы все еще формируются: разделение команд и навыков, улучшение вывода `/teach`, документация вне рабочих деревьев, поведение при декомпозиции задач и настройка частоты вывода.
6. Реальные паттерны: неверно vs верно
| Неверно | Верно | Причина |
|---|---|---|
| Установите все навыки и надейтесь, что агент знает ваш репозиторий. | Запустите `/setup-matt-pocock-skills` и настройте систему отслеживания задач, метки и пути к документации. | Некоторые навыки зависят от локальных соглашений. |
| Используйте `/tdd` в качестве метки для написания тестов постфактум. | Используйте его для red-green-refactor на небольших вертикальных срезах. | Ценность заключается в цикле обратной связи, а не только в тестовых файлах. |
| Запрашивайте улучшение архитектуры без документации по домену. | По возможности сначала создавайте общий язык и ADR. | Анализ архитектуры улучшается, когда агент понимает язык продукта. |
| Рассматривайте их как полноценный агентный фреймворк. | Рассматривайте их как компонуемые инструменты процесса. | Репозиторий намеренно сделан небольшим и адаптируемым. |
7. Частые ошибки и текущие проблемы
Issue tracker важен, потому что эти репозитории молоды и быстро меняются. В статье issues используются как сигналы риска, а не как доказательство непригодности проекта.
| Область | Детали | Почему это важно |
|---|---|---|
| Команды против навыков | PR #291 отслеживает разделение навыков на команды и навыки. | Семантика упаковки все еще дорабатывается. |
| Обучение навыку | В Issue #296 запрашивается улучшенное руководство по дереву и иерархическим диаграммам. | Некоторые навыки в процессе разработки все еще развиваются. |
| Расположение документации | В Issue #294 запрашивается документация вне рабочего дерева для `grill-with-docs`. | Рабочие процессы с документацией между рабочими деревьями требуют осторожности. |
| Декомпозиция задач | В Issue #292 говорится, что родительские задачи остаются доступными для выбора после декомпозиции. | Рабочие процессы `to-issues` могут потребовать ручной очистки. |
| Передача архитектуры | В Issue #290 запрашивается добавление кнопок передачи на страницах сгенерированной архитектуры. | Сгенерированные отчеты становятся артефактами рабочего процесса. |
| Частота вывода | В Issue #284 рассматривалась частота вывода `grill-with-docs`. | Навыки проведения интервью требуют темпа, соответствующего пользователю. |
8. Заметки о производительности, масштабировании и стоимости
Эти навыки в основном связаны с текстом и процессами, поэтому стоимость выполнения зависит от агента и размера репозитория, а не от тяжелой локальной сборки. Основные затраты токенов приходятся на длительные сессии опроса, анализ архитектуры, декомпозицию задач и многократное чтение кодовой базы.
Практический способ контроля расходов — выбор узкоспециализированных навыков. Используйте `/diagnose` для одного бага, `/tdd` для одного фрагмента, `/to-issues` для одного плана и `/handoff` для случаев, когда контекст необходимо сжать.
Ценность репозитория растет: общий язык, ADR, фрагменты задач и передача результатов уменьшают будущую неопределенность, что может сэкономить больше токенов, чем затраты на начальную сессию.
9. Для кого это
| Используйте, если | Пропустите, если |
|---|---|
| Вам нужны агентские рабочие процессы, которые сохраняют инженерную дисциплину. | Вам нужен автономный фреймворк, который берет на себя весь процесс целиком. |
| Вы используете Claude Code, Codex или совместимые агенты, понимающие навыки. | Ваш инструментарий не может загружать или адаптировать рабочие процессы `SKILL.md`. |
| Ваша команда ценит TDD, дисциплину отладки, ADR и порядок в задачах. | Вам нужно только быстрое однократное создание кода. |
| Вам удобно адаптировать небольшие навыки под соглашения вашего репозитория. | Вам нужен полностью хостируемый, строго структурированный продукт для управления проектами. |
10. Сигнал сообщества
Самый сильный сигнал сообщества — это существующая аудитория мейнтейнера в области TypeScript и AI-инженерии. README направляет людей через skills.sh и большую аудиторию рассылки AI Hero, что обеспечивает репозиторию мгновенное распространение.
Трекер задач продуктивно структурирован. Многие задачи касаются политики или рабочих процессов, а не только багов: проверка настройки, лимиты вопросов, область действия трекера задач, поведение родительских задач, пути к документации и упаковка команд.
Концепция репозитория приятно приземленная: он утверждает, что при работе с агентами основы важны как никогда.
11. Вердикт: стоит ли использовать?
Наш вывод
Используйте навыки Matt Pocock, если вам нужны небольшие, компонуемые рабочие процессы агентов, которые делают планирование, тестирование, диагностику, архитектуру, сортировку задач и передачу дел более дисциплинированными. Пропустите их, если вам нужен автономный фреймворк «в один клик» или репозиторий, скрывающий инженерный процесс за одной командой.
12. Общая картина
Этот репозиторий представляет собой зрелое направление в инструментарии для агентов: дело не в более крупных агентах, а в лучших ритуалах вокруг них. Навык — это обертка процесса, которая не дает модели слишком рано превращать неопределенность в код.
По мере того как AI-кодинг ускоряется, «узким местом» становятся суждения, ограничения, обратная связь и удобство сопровождения. Подобные небольшие навыки — один из способов внедрить эти инженерные привычки непосредственно в рабочий процесс агента.
13. Частые вопросы
В: Как установить навыки Matt Pocock?
В README рекомендуется `npx skills@latest add mattpocock/skills`, затем выбор нужных навыков и запуск `/setup-matt-pocock-skills`.
В: Работают ли они только с Claude Code?
Они написаны как агентные навыки и могут быть адаптированы для совместимых кодинг-агентов, поддерживающих навыки. Точное поведение при установке зависит от вашего агента и поддержки skills.sh.
В: С какого навыка мне начать?
Начните с `/setup-matt-pocock-skills`, затем используйте `/grill-with-docs` для новых функций, `/tdd` для реализации и `/diagnose` для исправления ошибок.
В: Что делает `/grill-with-docs`?
Он задает подробные вопросы о планируемых изменениях, формирует общий предметный язык, а также может обновлять контекстную документацию и ADR.
В: Является ли `/tdd` просто генерацией тестов?
Нет. Это рабочий процесс red-green-refactor для реализации небольших вертикальных срезов с четким циклом обратной связи.
В: Являются ли они заменой управлению проектами?
Нет. Такие навыки, как `/to-issues`, `/triage` и `/to-prd`, могут интегрироваться с рабочими процессами по задачам, но они не заменяют суждения команды или ответственность за процессы.
14. Глоссарий
| Область | Детали | Почему это важно |
|---|---|---|
| Навык | Повторно используемый рабочий процесс `SKILL.md` для агента. | Основной артефакт репозитория. |
| Глубокий опрос | Структурированное анкетирование перед реализацией. | Используется для уменьшения двусмысленности требований. |
| Общий язык | Специализированная предметная лексика проекта. | Хранится в документах, таких как `CONTEXT.md`. |
| ADR | Запись архитектурных решений (Architecture Decision Record). | Фиксирует важные технические решения. |
| Red-green-refactor | Напишите неработающий тест, добейтесь его прохождения, улучшите дизайн. | Основной цикл TDD. |
| Глубокий модуль | Модуль с простым интерфейсом и значительной внутренней глубиной. | Концепция качества архитектуры. |
| Передача (Handoff) | Структурированная передача контекста для будущей сессии или агента. | Снижает потерю контекста. |
15. Все источники и ссылки
Первоисточники
Проблемы и PR
Автор и сообщество
Внутренние ссылки
- Освоение навыков Agent TARS
- Руководство по навыкам академических исследований
- Руководство по лучшим практикам Claude Code
16. Таблица атрибуции источников
| Область | Детали | Почему это важно |
|---|---|---|
| README | Позиционирование, процесс установки, основные формулировки проблем, карта навыков. | Первоисточник. |
| Файлы навыков | Конкретное поведение для настройки, гриллинга, TDD, диагностики, архитектуры, проблем и передачи задач. | Первичный источник. |
| Скрипты и документация | Локальное связывание, листинг, контекстная документация, форматы ADR. | Источник структуры репозитория. |
| Issues и PR | Упаковка команд, путь к документации, обучение, декомпозиция задач и примечания по настройке. | Сигнал актуальности. |
| skills.sh | Канал распространения и описание установки. | Официальный источник экосистемы. |
Get the Ultimate Antigravity Cheat Sheet
Join 5,000+ developers and get our exclusive PDF guide to mastering Gemini 3 shortcuts and agent workflows.
Related Guides
Humanizer Skill Guide
blader/humanizer: 29 AI-writing patterns, voice calibration, and a two-pass audit, all in one Claude Code skill.
Guides & FeaturesMastering Agent Skills
The open standard for portable AI agent expertise.
Guides & FeaturesAntigravity Workflows Guide
Create automation recipes with Turbo Mode and AgentKit 2.0.
Guides & FeaturesHow to Change Antigravity Themes
Customize themes, dark mode, icons, and color schemes.
Guides & FeaturesHow to Change Language
Switch Antigravity to Spanish, German, Japanese, and more.
Guides & FeaturesAntigravity Security Guide
Known vulnerabilities, safe settings, and hardening steps.
