Matt Pocock открыл свой .claude: скиллы для настоящих инженеров

Личный .claude — теперь публичный

Matt Pocock — TypeScript-педагог, стоящий за платформой Total TypeScript, бывший инженер Vercel и Stately. Он известен тем, что учит разработчиков реальным паттернам, а не теоретическим конструкциям. На этот раз Поcock пошёл дальше: репозиторий mattpocock/skills — это его личный .claude-каталог, открытый для всех. Проект набрал более 20 400 звёзд на GitHub, что весомо для коллекции структурированных workflow-файлов, а не полноценного фреймворка.

Зачем это нужно

Автор создал эти скиллы, чтобы устранить типичные сбои, которые он наблюдает в Claude Code, Codex и других AI-агентах. Проблема хорошо знакома каждому, кто больше недели работал с подобными инструментами: агент не знает, как работает ваша команда — он не знает, что вы пишете тесты до реализации, какие git-операции требуют ручного подтверждения, архитектурных паттернов кодовой базы или конвенций по декомпозиции задач. Каждая сессия начинается с нуля.

Директории вроде .claude хранят кастомные инструкции, проектный контекст и специализированные промпты, которые направляют AI-модели к более качественному коду. Публикуя эти файлы, Поcock фактически делает open-source свою «ментальную модель» AI-коллаборации.

Четыре главные проблемы и как скиллы их решают

1. Агент сделал не то

Самый частый сбой в разработке — это рассогласование ожиданий. Решение — «grilling session» (допрос): агент задаёт детальные вопросы перед тем, как приступить к работе. Для этого есть скилл /grill-me и его расширенная версия /grill-with-docs.

2. Агент слишком многословен

Агент, попав в незнакомый проект, начинает «изобретать» терминологию — использует 20 слов там, где достаточно одного. Скилл /grill-with-docs решает это через создание общего языка: документа CONTEXT.md, где закреплён глоссарий проекта.

«There’s a problem with the materialization cascade» — вместо длинного описания того, что происходит с файловой системой при создании урока внутри раздела курса.

3. Код не работает

Скилл /tdd реализует разработку через тестирование с циклом red-green-refactor. Скилл /diagnosing-bugs — дисциплинированный цикл диагностики сложных багов и регрессий производительности: воспроизвести → минимизировать → выдвинуть гипотезу → инструментировать → исправить → написать регрессионный тест.

4. Кодовая база превратилась в «ball of mud»

Большинство приложений, написанных с агентами, сложны и тяжело поддаются изменениям. Агенты радикально ускоряют написание кода — а значит, ускоряют и деградацию архитектуры. Кодовая база усложняется с беспрецедентной скоростью. Скилл /improve-codebase-architecture помогает выявить архитектурные проблемы и восстановить порядок.

Быстрый старт

Установка занимает около 30 секунд:

npx skills@latest add mattpocock/skills

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

Карта скиллов

graph TD
    A[/setup-matt-pocock-skills/] --> B[User-invoked скиллы]
    A --> C[Model-invoked скиллы]
    B --> D[/grill-me/ — допрос перед задачей]
    B --> E[/grill-with-docs/ — допрос + CONTEXT.md]
    B --> F[/to-prd/ — конвертировать в PRD]
    B --> G[/to-issues/ — разбить на тикеты]
    B --> H[/improve-codebase-architecture/ — аудит архитектуры]
    B --> I[/prototype/ — выбросной прототип]
    C --> J[/tdd/ — red-green-refactor]
    C --> K[/diagnosing-bugs/ — диагностика багов]
    C --> L[/domain-modeling/ — доменная модель]

Сравнение подходов

Почему это важно для отрасли

Репозиторий skills отражает значимый тренд в developer-сообществе: переход приватных AI-воркфлоу в публичные образовательные ресурсы. Это подчёркивает растущую важность «prompt engineering» и «AI orchestration» как базовых компетенций инженера. Называя AI-конфигурационные файлы «скиллами», Поcock утверждает: умение настраивать и взаимодействовать с AI-моделью так же важно, как знание языка программирования.

Следить за обновлениями можно через рассылку автора — к ней уже подключились около 60 000 разработчиков. Репозиторий доступен на GitHub под лицензией MIT по адресу github.com/mattpocock/skills.