Cursor Custom Modes — это режим, в котором выбранный Agent Skill остаётся в контексте на каждом ходе, пока вы его не выключите. Обычный / + Enter вешает skill на одно сообщение; Option+Enter (Mac) или Alt+Enter (Windows) превращает тот же skill в режим. Канон: docs Prompting и docs Skills.

База по skills — Cursor Skills. Карта режимов Agent/Ask/Plan/Debug — Agent Mode. Старт — Cursor AI для начинающих. Pillar: n8n для начинающих.

Для кого Custom Modes

  • Нужен один playbook на длинную сессию (review, TDD, deploy SOP).
  • Skill описывает как работать, а не разовый таск.
  • Работаете в Agents Window или CLI и хотите badge режима на виду.
  • Команда держит навыки в .cursor/skills/ и хочет включать их целиком.

Если задача одноразовая — достаточно / + Enter без режима.

Как включить: маршрут на 10 минут

  1. Убедитесь, что skill лежит в .cursor/skills/ или другом discovery-пути и имеет YAML-frontmatter.
  2. В чате агента наберите / и найдите skill.
  3. Нажмите Option+Enter (Mac) или Alt+Enter (Windows) — либо «Use as Mode» в пункте меню.
  4. Проверьте badge режима на поле ввода чата.
  5. Работайте: skill подмешивается на каждом ходе, пока не выйдете из режима.
Действие Что происходит Когда брать
/ + Enter Skill на одно сообщение, потом сгорает Разовый чеклист / шпаргалка
/ + Option/Alt+Enter Custom Mode на всю сессию + badge Playbook на фичу или ревью
Exit mode Skill уходит из постоянного контекста Сменили задачу / закончили поток
icon + color в frontmatter Стиль badge режима Отличить режимы команды

Сводка по docs/agent/prompting и docs/skills (проверка 2026-09-03). Custom Modes доступны в Agents Window и CLI.

Frontmatter для режима

Любой skill с валидным frontmatter может стать Custom Mode. Для badge дока рекомендует опциональные поля icon и color. Пример из docs/skills:

---
name: tdd
description: Test-driven development playbook for this repo.
icon: beaker
color: green
---

Иконки вроде code, terminal, bug, beaker, shield, rocket. Неизвестные иконки/цвета откатываются к lightning.

Сильные стороны

  • Skill не «выпадает» через 2-3 хода длинной сессии.
  • Один и тот же пакет работает и как slash, и как режим.
  • Badge снижает путаницу: видно, какой playbook активен.
  • Работает и в IDE Agents Window, и в CLI.

Типичные ошибки

  • Путать Custom Mode с Plan / Ask / Debug — это не mode picker Shift+Tab, а skill-as-mode.
  • Вешать one-shot skill в режим и раздувать контекст без нужды.
  • Ждать Custom Mode без валидного frontmatter у SKILL.md.
  • Путать с Cursor Skills как темой: skills = пакеты, Custom Modes = способ их держать включёнными.

FAQ: Cursor Custom Modes

Что такое Cursor Custom Modes?

Custom Modes — способ держать skill в контексте на всю сессию агента, а не на одно сообщение. Включаете skill через / меню и Option+Enter (Mac) или Alt+Enter (Windows). Канон: docs/agent/prompting и docs/skills.

Чем Custom Mode отличается от обычного /skill?

Обычный Enter прикрепляет skill к одному сообщению, потом он «сгорает». Custom Mode держит skill на каждом ходе, пока вы не выйдете из режима. На вводе чата виден badge режима.

Где работают Custom Modes?

В Agents Window и в CLI. Любой skill с валидным YAML-frontmatter может стать режимом. Поля icon и color стилизуют badge.

Для каких задач брать Custom Mode?

Для playbook-навыков: code-review чеклист, /tdd на всю фичу, командный SOP. Не для разовых one-shot задач, где хватит одного /skill.

Как оформить badge режима?

В frontmatter SKILL.md задайте icon (например beaker, rocket, shield) и color (default, green, cyan, blue, purple, magenta, orange, yellow, red, brand). Неизвестные значения откатываются к lightning.

Вывод

Cursor Custom Modes — skill как режим на сессию: / → Option/Alt+Enter → badge → работаете по playbook. Разовые подсказки оставляйте на Enter. Карта skills: гайд Skills.

Артём Денисов эксперт Нетологии и автор курса Яндекс Практикума по промпт-инжинирингу. Держит Custom Modes на длинных ревью и TDD-потоках в контентных репозиториях.

Хотите нейросети под свои задачи, а не «для всех»?

Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артём Денисов — все форматы на странице обучения. Тех-pillar — n8n для начинающих.