Навыки агента (Agent Skills) в Cursor — это открытый стандарт для расширения ИИ-агента специализированными возможностями. Навык инкапсулирует доменную экспертизу и рабочие процессы, которые агент использует для выполнения конкретных задач. В этом материале — что такое навыки, как они работают, где хранятся и как создавать свои.
Что такое навыки в Cursor
Навык — это переносимый, версионируемый пакет, который обучает агента выполнению задач, специализированных под конкретную предметную область. Навыки могут включать как инструкции (текст в SKILL.md), так и исполняемые скрипты или код, который агент может запускать. Они переносимые (работают с любым агентом, поддерживающим стандарт Agent Skills), версионируемые (хранятся в виде файлов, можно отслеживать в репозитории или устанавливать через GitHub), исполняемые (могут содержать скрипты и код) и постепенные (ресурсы подгружаются по мере необходимости, что экономит контекст).
💡 Стандарт Agent Skills открытый; подробности — на agentskills.io. Навыки в Cursor автоматически обнаруживаются в каталогах .cursor/skills/, ~/.cursor/skills/ и аналогах для Claude и Codex.
Как работают навыки
При запуске Cursor автоматически обнаруживает навыки в каталогах навыков и делает их доступными агенту. Агенту показываются доступные навыки, и он по контексту решает, когда их применить. Навыки также можно вызывать вручную: наберите / в чате агента и выполните поиск по имени навыка (например, /deploy-app или /migrate-to-skills). По умолчанию навыки автоматически применяются, когда агент считает их подходящими; если нужно, чтобы навык срабатывал только при явном вызове, в frontmatter укажите disable-model-invocation: true.
Каталоги навыков и структура
Навыки загружаются из следующих каталогов. На уровне проекта: .cursor/skills/, .claude/skills/, .codex/skills/ — только текущий проект. На уровне пользователя: ~/.cursor/skills/, ~/.claude/skills/, ~/.codex/skills/ — все проекты пользователя. Каждый навык должен быть каталогом с файлом SKILL.md в корне. Пример минимальной структуры: .cursor/skills/my-skill/SKILL.md. Расширенная структура может включать необязательные каталоги scripts/ (исполняемый код), references/ (дополнительная документация, загружается по запросу), assets/ (шаблоны, изображения, файлы данных). Делайте основной SKILL.md компактным и выносите подробные справочники в отдельные файлы — так агент подгружает ресурсы постепенно и эффективнее использует контекст.
Формат SKILL.md и поля frontmatter
Каждый навык описывается в файле SKILL.md с YAML-фронтматтером в начале (между ---). Обязательные поля: name — идентификатор навыка (строчные буквы, цифры и дефисы; должен совпадать с именем родительской папки); description — что делает навык и когда его использовать; по нему агент определяет релевантность. Необязательные поля: license (название лицензии или ссылка на файл), compatibility (требования к окружению: системные пакеты, сеть и т.п.), metadata (произвольная структура ключ–значение), disable-model-invocation (если true, навык включается только при явном вызове через /skill-name). После YAML идёт заголовок и текст: когда использовать, пошаговые инструкции, доменные соглашения, лучшие практики. Упоминайте использование инструмента «задать вопрос пользователю», если нужно уточнять требования.
Добавление скриптов в навыки
Навыки могут включать каталог scripts/ с исполняемым кодом, который агент запускает. В SKILL.md ссылайтесь на скрипты относительными путями от корня навыка, например: «Запустите скрипт развертывания: scripts/deploy.sh <environment>», «Перед развертыванием запустите python scripts/validate.py». Агент читает инструкции и выполняет соответствующие скрипты при вызове навыка. Скрипты могут быть на Bash, Python, JavaScript или в другом формате, поддерживаемом агентом. Скрипты должны быть самодостаточными, содержать понятные сообщения об ошибках и корректно обрабатывать пограничные случаи.
Просмотр и установка навыков
Чтобы просмотреть обнаруженные навыки: откройте Cursor Settings (Cmd+Shift+J на Mac, Ctrl+Shift+J на Windows/Linux), перейдите в раздел Rules — навыки отображаются в блоке Agent Decides. Установка навыков из GitHub: откройте Cursor Settings → Rules, в Project Rules нажмите Add Rule, выберите Remote Rule (Github) и введите URL репозитория на GitHub. Так можно подключать готовые навыки из сообщества или своих репозиториев.
Миграция правил и команд в навыки
В Cursor 2.4 есть встроенный навык /migrate-to-skills, который помогает преобразовать существующие динамические правила и слэш-команды в навыки. Навык миграции преобразует: динамические правила (правила с «Apply Intelligently» — alwaysApply: false или без этого параметра и без определённых globs) в стандартные навыки; слэш-команды (и пользовательские, и уровня рабочего пространства) в навыки с disable-model-invocation: true, сохраняя явное поведение вызова. Чтобы выполнить миграцию: введите /migrate-to-skills в чате агента; агент определит подходящие правила и команды и преобразует их в навыки; просмотрите сгенерированные навыки в .cursor/skills/. Правила с alwaysApply: true или с конкретными шаблонами globs не мигрируются — у них явные условия срабатывания. Пользовательские правила, не хранящиеся в файловой системе, тоже не мигрируются.
Навыки и субагенты: когда что использовать
Навыки подходят для узких, одноцелевых задач: сгенерировать changelog, отформатировать код, развернуть приложение по готовому скрипту. Они не создают отдельного контекстного окна — агент просто подгружает инструкции и скрипты навыка. Субагенты нужны, когда важна изоляция контекста (долгие исследования, объёмный вывод), параллельное выполнение нескольких потоков или специализированная экспертиза на многих шагах. Если задача простая и не требует отдельного контекста, оформляйте её как навык; если нужен отдельный «помощник» с собственным контекстом — субагент.
Пример навыка: развертывание приложения
Пример структуры: .cursor/skills/deploy-app/SKILL.md с frontmatter name: deploy-app и description о развертывании в staging или production; каталог scripts/ с deploy.sh и validate.py. В теле SKILL.md — разделы «Использование» (запуск scripts/deploy.sh <environment>, где environment — staging или production) и «Проверка перед развертыванием» (запуск python scripts/validate.py). Агент при вызове навыка или при упоминании развертывания/релизов подставит контекст и выполнит нужные шаги.
Рекомендации по созданию навыков
Делайте описание (description) конкретным — от него зависит автоматический выбор агентом. Указывайте, когда использовать навык и при каких формулировках пользователя. Держите основной SKILL.md коротким; детали выносите в references/ или в подразделы. Скрипты в scripts/ делайте идемпотентными где возможно и с явной обработкой ошибок. Добавляйте .cursor/skills/ в репозиторий, чтобы командой пользовались одни и те же навыки. Проверяйте навык в чате: вызовите его по имени и по контексту и убедитесь, что агент применяет его в нужных случаях.
Частые вопросы
Чем навык отличается от субагента?
Навык — пакет инструкций и (опционально) скриптов, который агент подгружает в свой контекст. Отдельного контекстного окна нет. Субагент — отдельный ИИ-помощник со своим контекстом, которому родительский агент делегирует задачу. Навыки лучше для быстрых, одношаговых или повторяемых сценариев; субагенты — для сложных, длительных или параллельных задач.
Можно ли отключить автоматический вызов навыка?
Да. В frontmatter SKILL.md укажите disable-model-invocation: true. Тогда навык будет добавляться в контекст только при явном вводе /skill-name в чате, как обычная команда с косой чертой.
Где смотреть документацию по стандарту Agent Skills?
Открытый стандарт описан на agentskills.io. Там можно найти формат, примеры и совместимость с разными агентами.
Итог
Навыки агента в Cursor — переносимый, версионируемый способ расширить агента доменной экспертизой и скриптами. Каталоги .cursor/skills/ и ~/.cursor/skills/, файл SKILL.md с YAML и инструкциями, опциональные scripts/, references/, assets/ — всё это позволяет держать инструкции компактными и подгружать ресурсы по мере необходимости. Навыки вызываются автоматически по контексту или вручную через /имя-навыка; миграция правил и слэш-команд в навыки выполняется через /migrate-to-skills. Для простых, повторяемых задач используйте навыки; для сложных потоков с изоляцией контекста — субагентов.
