Три сущности путают, потому что все три — «текст для агента». Разница не в markdown, а в когда это читают. Если скопировать одно и то же в Rules, /команда и SKILL.md, агент спорит сам с собой.
Отдельные гайды уже есть: Rules, Skills, Commands. Здесь только граница.
Одна таблица
| Rules | Command | Skill | |
|---|---|---|---|
| Когда | Почти каждый чат, часто по globs | Вы вызвали /имя | Задача похожа на сценарий |
| Длина | Короткий договор | Один абзац ТЗ | Чеклист шагов |
| Где | .cursor/rules/*.mdc, User Rules | команды пользователя / team | .cursor/skills/…/SKILL.md |
| Пример | «не коммить .env, не force-push» | /commit-msg | «как выкатить на VPS» |
Custom Mode — skill, включённый на весь чат. Это не четвёртая сущность: режим из skill.
Rules
Постоянное. Язык ответов, запреты, стек, globs на *.py. Меняется редко. Секреты не сюда. Проверка: новый чат → «какие правила ты видишь?».
Не пишите в Rules сценарий деплоя на два экрана. Агент будет тащить его в переименование кнопки. Длинное — skill. Точечный удар — command.
.mdc и globs — отдельный разбор. Старый .cursorrules не размножайте.
Commands
Один вызов, один результат: ревью диффа, текст коммита, «опиши PR». Если после /review вы всё равно пишете второе ТЗ на полстраницы — это уже skill, команду оставьте короткой.
Не дублируйте Rules внутри команды: «и ещё не коммить секреты» уже должно жить в правилах. Team commands с дашборда — про организацию, не про ваш slug: Teams.
Skills
Сценарий: деплой, контент, ревью с чеклистом. Имя папки = тема. Три skills на проект хватает. Если не срабатывает — формулировка задачи не совпала, не «сломался Cursor».
Skill не заменяет статью на сайте и не заменяет git-хук. Для людей — гайд. Для CI — CI. Для агента в IDE — SKILL.md.
Hooks вокруг событий — другой слой. Туда не копируйте skill.
Как не сложить три копии
- Запрет и стиль → Rules.
- Один повторяющийся абзац ТЗ → Command.
- Цепочка из пяти шагов с проверкой → Skill.
- Нашли одно и то же в двух местах — удалите из более частого (обычно из Rules).
Прогон: новый чат без /, узкая правка. Если агент вдруг деплоит — skill или mode торчат где не надо. Выключите mode, сузьте Rules.
Коротко
Rules держат рамку. Command экономит копипаст. Skill ведёт сценарий. Если сомневаетесь — начните с Rules и одной команды. Skills добавляйте, когда одну и ту же цепочку объясняете третий раз.
Частые ошибки
«Положил деплой в Rules, чтобы наверняка». Агент тащит деплой в правку CSS. Вынесите.
«Написал skill на 200 строк как README». Модель теряет середину. Пять шагов и критерий готовности.
«Команда /do-everything». Это не command. Разрежьте.
После апдейта Cursor имена в палитре команд могли смениться. Смотрите свою сборку, не скрин 2024 года. Changelog — в релизах.
AGENTS.md в корне — ещё один договор для агентов, не замена .mdc. Не плодите четвёртую простыню «на всякий»: либо короткий AGENTS.md со ссылкой на Rules, либо только Rules. Команде проще один источник правды. Если агент цитирует устаревший skill — удалите файл, не комментируйте «deprecated» внутри: модель всё равно может подхватить.