Установка Cursor Agent Skills: mattpocock/skills

Симптом: mattpocock/skills установлен, но Cursor не показывает навыки или команда получает разные результаты.
Самое быстрое решение: из корня нужного репозитория выполните npx skills@latest add mattpocock/skills, выберите setup-matt-pocock-skills, затем один раз запустите /setup-matt-pocock-skills в Cursor Agent.

Этот вариант подходит для командных проектов: файлы попадают в репозиторий, проходят Git-проверку и могут воспроизводиться на другом Mac. Skills отвечают за запускаемые по ситуации инженерные процессы, а Cursor Rules — за постоянные ограничения проекта. Если вы используете Claude Code, выбирайте между плагином и редактируемыми файлами через skills.sh: совместная установка создаёт дубликаты.

Кому стоит читать:

• разработчикам, которым нужны TDD, диагностика, triage и code review прямо в Cursor;
• техническим руководителям, которые хотят хранить поведение Agent в Git;
• распределённым командам, где один и тот же репозиторий открывается на локальном и удалённом Mac.

Последняя проверка — 13 августа 2026 года. Команды и имена навыков сверены с README репозитория mattpocock/skills, документацией Cursor Agent Skills и страницей набора в skills.sh. Поддержка Agent Skills появилась в Cursor 2.4; соответствующие изменения описаны в официальном журнале изменений Cursor 2.4.

До установки: проектный каталог против глобальной директории

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

cd /путь/к/вашему-репозиторию
git status
git branch --show-current

Проверка должна показать ожидаемый проект, чистую или понятную рабочую ветку и доступ на запись. Отдельная ветка для первого внедрения полезнее, чем установка прямо в main: вы сможете просмотреть новые скрипты, ссылки и инструкции до слияния.

Cursor поддерживает четыре основные области обнаружения навыков:

Для командной установки это не означает, что нужно копировать один и тот же набор во все места. Выберите одну проектную точку, иначе одинаковые имена могут появиться в нескольких областях видимости. Если команда работает только с Cursor, практичнее закрепить .cursor/skills/ или .agents/skills/ в документации репозитория и не смешивать оба варианта без причины.

Внутри корня навыка должен находиться именно файл SKILL.md:

.cursor/
└── skills/
    └── tdd/
        └── SKILL.md

В SKILL.md обязательны поля name и description. Имя должно совпадать с названием родительской папки. Поле disable-model-invocation: true отключает автоматический выбор навыка: он останется доступен для ручного вызова через /имя-навыка, но Agent не будет применять его по контексту.

Перед запуском проверьте:

На Mac заранее откройте проект в Cursor из того же каталога. Если терминал находится в одном репозитории, а окно Cursor — в другом, диагностика «навыки не видны» начнётся с ложного предположения.

Установка Cursor Agent Skills через skills.sh

Для Cursor используйте редактируемую установку через skills.sh. На странице mattpocock/skills команда указана в таком виде:

npx skills@latest add mattpocock/skills

Запускайте её из корня целевого репозитория, а не из домашнего каталога:

cd ~/Projects/example-app
npx skills@latest add mattpocock/skills

Установщик предложит выбрать набор навыков и целевого Agent. Не нужно автоматически подключать весь список. Для первого прохода выберите setup-matt-pocock-skills, а затем добавьте только те процессы, которые уже нужны команде: например, TDD, triage, диагностику или code review. Страница набора в skills.sh сейчас показывает 51 навык и 15,3 млн установок, но популярность не заменяет проверку содержимого и разрешений.

Проверьте итог сразу после установки:

find .cursor .agents -name SKILL.md -print 2>/dev/null
git status --short
git diff --stat

Если установщик выбрал .agents/skills/, это не обязательно ошибка: Cursor обнаруживает оба проектных каталога. Для единообразия команды зафиксируйте один вариант в документации репозитория. Не переносите файлы вручную между .cursor/skills/ и .agents/skills/, пока не проверили, не создали ли вы вторую копию.

В README mattpocock/skills отдельно сказано, что plugin для Claude Code устанавливает управляемый набор только для чтения, а skills.sh копирует обычные редактируемые файлы в проект. Это две разные модели сопровождения:

Для Cursor и командного проекта выбирайте skills.sh. Если один участник работает в Claude Code, он должен согласовать с командой режим установки, а не добавлять плагин поверх тех же файлов.

Первичная конфигурация: ручной setup против автоматического выбора

После установки откройте тот же репозиторий в Cursor Agent и вызовите:

/setup-matt-pocock-skills

Этот навык нужно вызвать вручную. Он не должен сам запускаться при каждом запросе. По README и отдельному описанию навыка, setup уточняет три группы решений:

• где команда ведёт задачи — GitHub, GitLab, локальные Markdown-файлы или другой трекер;
• какие метки использует triage;
• где хранить создаваемую доменную документацию.

После диалога ожидайте проверяемые артефакты, а не только сообщение «готово»:

docs/
└── agents/
    ├── domain.md
    ├── issue-tracker.md
    └── triage-labels.md

Файл triage-labels.md появляется только если вы установили соответствующий навык. В AGENTS.md или CLAUDE.md также может появиться раздел ## Agent skills со ссылками на созданную конфигурацию. setup-matt-pocock-skills не является генератором без вопросов: он исследует репозиторий, предлагает варианты и просит подтверждение. Подробное описание ожидаемого процесса приведено в документе setup-matt-pocock-skills.

После завершения проверьте:

git status --short
git diff -- AGENTS.md CLAUDE.md docs/agents

Сохраните в командной документации решения, которые вы приняли. Например:

• задачи хранятся в GitHub Issues;
• triage использует существующие метки проекта;
• доменные документы находятся в docs/agents/;
• изменения в навыках проходят ревью владельца репозитория.

Это важнее самого запуска setup. Если новый разработчик не понимает, почему triage выбирает конкретную метку или где искать domain docs, команда получила набор файлов, но не получила воспроизводимый процесс.

Если mattpocock/skills не появился в Cursor

Отсутствие навыка обычно связано не с самим репозиторием, а с областью видимости или структурой файлов. Последовательно проверьте пять точек.

1. Открыт ли правильный корень проекта

В терминале:

pwd
git rev-parse --show-toplevel

Сравните результат с папкой, открытой в Cursor. Если репозиторий — монорепозиторий, убедитесь, что навык не лежит во вложенном проекте, область которого не совпадает с текущими файлами.

2. Есть ли вложенная папка навыка

Правильно:

.cursor/skills/setup-matt-pocock-skills/SKILL.md

Неправильно:

.cursor/skills/SKILL.md
.cursor/skills/setup-matt-pocock-skills.md

Cursor ищет SKILL.md внутри папки конкретного навыка. Он также поддерживает вложенные категории, но идентификатором остаётся папка, где лежит сам SKILL.md.

3. Проверена ли YAML-шапка

Минимальная структура должна содержать:

---
name: setup-matt-pocock-skills
description: Configure this repository for the engineering skills.
---

Проверьте совпадение name с именем папки. Ошибка в отступе, незакрытая YAML-шапка или лишний символ в имени могут сделать навык недоступным.

4. Не отключён ли автоматический вызов

Если файл содержит:

disable-model-invocation: true

навык может отсутствовать в автоматическом выборе Agent, но оставаться доступным через:

/setup-matt-pocock-skills

Это не то же самое, что «файл не обнаружен». Сначала проверьте slash-меню, затем раздел Skills в интерфейсе Cursor. Если навык виден в настройках, но не появляется в меню, зафиксируйте версию Cursor и минимальную структуру файла перед дальнейшей отладкой.

5. Перезагружен ли рабочий контекст

Закройте и заново откройте папку в Cursor после изменения скрытых каталогов. Затем проверьте раздел Customize → Skills и введите / в Agent chat. Если после перезагрузки навык по-прежнему не обнаружен, сравните проектную и глобальную области, а не устанавливайте второй экземпляр.

Skills против Cursor Rules: динамический процесс против постоянного ограничения

На этом этапе нужно разделить обязанности. Cursor описывает Skills как динамически подключаемые процедуры, а Rules — как постоянный контекст и инструкции проекта. Skills могут включать скрипты, ссылки и шаблоны; Rules должны задавать то, что нельзя нарушать независимо от типа задачи. Подробное сравнение этих механизмов приведено в руководстве Cursor по практикам работы с Agent.

Практический пример:

• «Все публичные API должны иметь тесты и обратную совместимость» — Cursor Rule.
• «При добавлении endpoint сначала составь тест, затем запусти цикл TDD» — Skill.
• «Не использовать библиотеку X без согласования» — Cursor Rule.
• «Проведи проверку PR по списку и сформируй замечания» — Skill.
• «Команда использует TypeScript strict mode» — Cursor Rule.
• «Диагностируй падение CI по журналам и предложи минимальный фикс» — Skill.

Не включайте весь набор mattpocock/skills на каждый запрос. Начните с одного небольшого задания: например, добавьте функцию с тестом, затем попросите Agent провести review. Вы должны увидеть, какой навык применился, какие файлы он прочитал и запускал ли он ожидаемый скрипт.

Первая рабочая задача: проверка не по меню, а по результату

После setup выполните небольшой сценарий на реальном коде. Не используйте пустой тестовый файл: он не показывает, понимает ли Agent доменную конфигурацию.

Подход:

1. Создайте короткое техническое требование в формате, который команда реально использует.
2. Вызовите нужный навык явно через /, если хотите исключить ошибку автоматического выбора.
3. Проверьте, что Agent прочитал AGENTS.md, CLAUDE.md или документы из docs/agents/.
4. Попросите выполнить одну ограниченную операцию — тест, диагностику или ревью.
5. Сравните diff, логи тестов и ссылки на документы.
6. Отмените изменения и повторите сценарий в чистой ветке.

Не записывайте в новые инструкции старые имена навыков из чужих статей. Состав набора развивается. Перед публикацией внутреннего runbook откройте текущую директорию skills/ в установленной версии и используйте только реально существующие названия.

Минимальный критерий успешной проверки:

• нужный навык виден в Cursor;
• ручной вызов работает;
• автоматический выбор не срабатывает на нерелевантной задаче;
• созданный diff соответствует задаче;
• тест или проверка действительно запускается;
• настройки из docs/agents/ используются, а не просто лежат в репозитории.

Командное сопровождение: обновление против прямой перезаписи

Редактируемые файлы — преимущество skills.sh, но одновременно зона ответственности. Не принимайте обновление только потому, что у upstream выросло число установок или изменилось описание.

Разделите файлы на три группы:

Перед обновлением создайте ветку и сохраните текущий diff:

git switch -c chore/update-agent-skills
git status --short
git diff -- .cursor .agents docs/agents AGENTS.md CLAUDE.md

Затем изучите изменения upstream и только после этого запускайте:

npx skills update

Проверьте, не перезаписаны ли командные правки. Отдельно просмотрите:

• новые scripts/;
• shell-команды и вызовы внешних инструментов;
• ссылки на GitHub, GitLab или локальные каталоги;
• инструкции, которые могут отправлять изменения или выполнять опасные операции;
• новые разрешения, требуемые для запуска.

Внешний навык — это не только Markdown. В официальной структуре Cursor предусмотрены scripts/, references/ и assets/; скрипты могут выполняться Agent, поэтому каждый такой файл должен пройти обычное ревью безопасности.

Приёмка на локальном и удалённом Mac

Если команда работает на удалённом Mac, проверяйте не обещание «одинаковая среда», а конкретные артефакты. Начните с одного и того же commit и одинакового набора установленных навыков.

Чек-лист приёмки:

• [ ] репозиторий открыт из ожидаемого корня;
• [ ] выбран единый проектный каталог: .cursor/skills/ или .agents/skills/;
• [ ] SKILL.md найден внутри каждой папки навыка;
• [ ] поля name и description заполнены;
• [ ] setup-mattpocock-skills вызван вручную;
• [ ] файлы в docs/agents/ появились или были подтверждённо пропущены;
• [ ] раздел ## Agent skills записан в принятую командой документацию;
• [ ] навык отображается в Cursor Customize → Skills;
• [ ] ручной вызов через / работает;
• [ ] тестовая задача даёт ожидаемый diff;
• [ ] после перезагрузки Cursor состояние не исчезает;
• [ ] локальная и удалённая копии имеют одинаковый commit конфигурации;
• [ ] сторонние скрипты прошли проверку владельцем репозитория;
• [ ] откат на предыдущую ветку восстанавливает рабочее состояние.

Итог приёмки должен иметь один из трёх статусов:

Не приписывайте удалённому Mac поведение, которое вы не проверяли. Различия могут появиться из-за версии Cursor, прав на запись, оболочки, Git-конфигурации или состояния рабочего каталога. Для временного удалённого рабочего места полезно заранее зафиксировать последовательность открытия проекта, установки Node-инструментов, перезагрузки Cursor и проверки Git diff. Параметры самого рабочего места можно сверить через консоль MacHTML, а вопросы по доступу и инициализации — через справочные материалы MacHTML.

Если локальная установка проходит, а удалённая нет, сначала сравните commit и дерево файлов. Не начинайте с повторной установки в глобальный каталог: так вы потеряете воспроизводимость и усложните поиск причины.

Для разовой проверки или распределённой команды текущий подход на собственном Mac часто скрывает три недостатка: настройки завязаны на конкретный компьютер, восстановление после сбоя требует ручной работы, а новые участники получают неполный набор локальных зависимостей. Когда рабочее место нужно быстро воспроизвести, безопаснее вынести среду Cursor в управляемый удалённый Mac, проверить её по этому же чек-листу и сохранить возможность отката. В таком сценарии аренда MacHTML полезнее постоянной ручной сборки — не как замена долгоживущей серверной инфраструктуре, а как способ выдать команде отдельное место для тестирования Agent Skills, ревью и приёмки без изменения рабочих машин разработчиков.