Навык - это способ превратить повторяемую процедуру в продукт. Технически это папка с обязательным описанием и опциональными каталогами для скриптов, справочных материалов и вспомогательных файлов. Cursor ищет их в нескольких стандартных местах, включая совместимые каталоги других агентных инструментов, а вложенный навык автоматически получает область действия своего подкаталога. Смысл механизма не в хранении текста, а в том, что процедура подгружается тогда, когда нужна, и не занимает места, пока не нужна.

Наивная альтернатива - объяснять один и тот же порядок действий заново в каждом разговоре. Это работает, но плохо масштабируется: формулировка каждый раз чуть другая, шаги теряются, а результат зависит от того, насколько подробно вы сегодня написали запрос. Хуже всего это заметно при передаче работы: то, что живёт в вашей привычке набирать запрос, не переезжает к коллеге вместе с репозиторием. Навык фиксирует порядок, и с этого момента процедура выполняется одинаково, а её изменения проходят через обычное ревью, как код.

Прогрессивная загрузка - главная инженерная идея здесь. В начальном контексте видно только имя и описание навыка; полное содержимое подтягивается при активации, а тяжёлые материалы - справочники, шаблоны, скрипты - только тогда, когда до них дошло дело. Поэтому основной файл держат коротким: условие запуска, предварительные требования, упорядоченные шаги, условия остановки и требуемые доказательства. Всё объёмное выносят в отдельные каталоги. Экономия здесь не декоративная: десяток навыков, каждый из которых грузится целиком, съедает контекст ещё до начала работы.

Полезно один раз увидеть каркас навыка целиком. Ниже - заголовок с именем, описанием и масками путей и тело из четырёх шагов, где последний шаг - явная остановка перед действием с внешними последствиями. Именно условие остановки отличает навык-инструкцию от навыка-автомата: процедура доводит работу до точки решения и передаёт её человеку. Обратите внимание и на требование доказательств в последнем пункте: без него отчёт превращается в утверждение, что всё хорошо, а проверить это утверждение нечем.

Описание в заголовке несёт больше веса, чем кажется. По нему модель решает, релевантен ли навык текущей задаче, поэтому оно должно называть момент применения, а не абстрактную способность. Формулировка проверить релиз-кандидат и собрать чек-лист работает; формулировка помогает с релизами - нет. Есть и обратный случай: если навык должен запускаться только человеком, автоматический подбор отключают явным полем. Так поступают с процедурами, у которых цена ложного срабатывания выше, чем польза от автоматического включения.