Навыки (Skills) и субагенты в Cursor — два способа усилить встроенного ИИ-агента: навыки дают ему новые «умения» через инструкции и скрипты, субагенты позволяют делегировать части задачи отдельным помощникам с собственным контекстом. В одном посте — что это, как работает и когда что использовать.
Что такое навыки в Cursor
Навык — это переносимый пакет с инструкциями (и при желании скриптами), который обучает агента выполнять задачи в конкретной области. Агент не получает отдельное окно чата: он просто подгружает описание навыка и при необходимости запускает скрипты. Навыки версионируемые, их можно хранить в репозитории и ставить из GitHub.
• Где лежат: проект — `.cursor/skills/`, для всех проектов — `~/.cursor/skills/`
• Формат: папка с файлом `SKILL.md`, в начале — YAML (name, description), далее текст с инструкциями
• Вызов: автоматически по контексту или вручную через `/имя-навыка` в чате
Стандарт Agent Skills открытый; подробности — на agentskills.io. В Cursor навыки подхватываются из указанных каталогов без дополнительной настройки.
Что такое субагенты в Cursor
Субагент — отдельный ИИ-помощник со своим контекстным окном. Родительский агент передаёт ему задачу и нужный контекст, субагент работает автономно и возвращает результат. Так не раздувается основной диалог и можно запускать несколько потоков параллельно.
• Встроенные: Explore (поиск по коду), Bash (shell-команды), Browser (браузер через MCP) — подключаются автоматически
• Свои субагенты: файлы в `.cursor/agents/` (проект) или `~/.cursor/agents/` (все проекты), формат — Markdown с YAML (name, description, model, is_background и др.)
• Вызов: агент делегирует сам по сложности задачи или явно: `/имя-субагента задача`
На тарифах с оплатой за запросы для субагентов нужно включить Max Mode; в планах с оплатой по использованию субагенты доступны по умолчанию.
Как работают навыки
Cursor при старте сканирует каталоги навыков и показывает агенту их список. Агент решает по описанию (description), когда применить навык. Можно отключить авто-вызов: в frontmatter указать `disable-model-invocation: true` — тогда навык сработает только при явном вводе `/имя-навыка`. В навык можно добавить папку `scripts/` с bash/python/js — агент будет запускать их по инструкциям из SKILL.md.
Как работают субагенты
Субагент получает от родителя запрос с контекстом и выполняется в своём окне (без доступа к истории основного чата). Режимы: передний план — родитель ждёт ответа; фон — управление возвращается сразу, вывод субагента пишется в `~/.cursor/subagents/`. Параллельный запуск: в одном сообщении можно попросить, например, «сделай A и B параллельно» — агент запустит несколько субагентов. Возобновление по идентификатору агента тоже поддерживается.
Подписывайся на наш Telegram
— там разбираем Cursor и автоматизацию по шагам.
Когда использовать навыки, а когда — субагентов
Навыки — для узких, одноцелевых сценариев без отдельного контекста: сгенерировать changelog, отформатировать код, развернуть по готовому скрипту. Один контекст, быстрый результат.
Субагенты — когда важны изоляция контекста (долгое исследование кодовой базы, объёмный вывод), параллельное выполнение нескольких задач или специализированная экспертиза на многих шагах (например, Planner → Implementer → Verifier). Отдельное окно и свой контекст — их главное преимущество.
Кратко: простая повторяемая задача без «шумного» промежуточного результата — навык; сложный или длинный поток с изоляцией или параллелизмом — субагент.
Как создать свой навык
Создайте папку, например `.cursor/skills/my-skill/`, и в ней файл `SKILL.md`. В начале — YAML между `---`: обязательные поля `name` (латиница, дефисы) и `description` (когда использовать). После YAML — заголовок и пошаговые инструкции; при необходимости укажите вызов скриптов из `scripts/`. Делайте description конкретным — от него зависит автоматический выбор агентом. Миграцию старых правил и слэш-команд в навыки можно выполнить через встроенный навык `/migrate-to-skills`.
Как создать своего субагента
Создайте файл в `.cursor/agents/`, например `verifier.md`. В начале — YAML: `name`, `description` (формулируйте чётко — от этого зависит делегирование), при желании `model`, `readonly`, `is_background`. После YAML — краткий промпт: что делать при вызове. Рекомендуется 2–3 узконаправленных субагента с одной зоной ответственности; добавляйте `.cursor/agents/` в репозиторий, чтобы командой пользовались одни и те же агенты.
Кратко по инструментам
• Навыки: пакет инструкций и скриптов, один контекст агента, вызов по имени или по контексту; каталоги `.cursor/skills/`, `~/.cursor/skills/`; формат SKILL.md с YAML.
• Субагенты: отдельный контекст, делегирование задач, параллельный запуск и фоновый режим; встроенные Explore, Bash, Browser; свои — в `.cursor/agents/` и `~/.cursor/agents/`.
Используйте навыки для быстрых повторяемых действий, субагентов — для сложных потоков, изоляции контекста и параллельной работы. Подробнее по стандарту навыков — на agentskills.io; по субагентам и настройке — в документации Cursor.
Подписывайся на наш Telegram — там ещё больше про Cursor и ИИ в разработке.