| Уровень | 🛠 сложная |
| Время | ~2 часа |
| Понадобится | инструмент, который поддерживает свои скиллы или команды (Claude Code, Cursor, Cline — у каждого своё), и повторяющаяся задача |
| Качает | превращать повторяемое в инструмент вместо того, чтобы объяснять заново |
Файл проекта описывает правила. Скилл описывает процедуру: как мы тут
делаем вот эту конкретную вещь. Разница в том, что скилл подтягивается только
когда нужен, и потому может быть подробным.
Найдите у себя действие, которое вы объясняли агенту хотя бы трижды, и
оформите его скиллом.
Кандидаты, которые обычно есть у всех:
Устройство зависит от инструмента — посмотрите в его документации, как это
называется у вас. В Claude Code скилл — это каталог .claude/skills/<имя>/ с
файлом SKILL.md, у которого во фронтматтере есть name и description;
лежать он может в проекте или в личном каталоге. У других инструментов свои
файлы правил и свои слэш-команды — суть одна.
Главное поле — description. Именно по нему инструмент решает, доставать
скилл или нет. «Работа с API» — плохо. «Заводит новую ручку в api/: спека,
хендлер, тест, регистрация в роутере» — хорошо.
Скилл не подхватится. Первая проверка — имя каталога и файла, вторая —
фронтматтер, третья — описание. Спросите у агента прямо, какие скиллы он
видит: это быстрее, чем гадать.
Скилл будет срабатывать на всё подряд. Обратная беда, и она хуже: он
занимает место и тянет за собой ненужную процедуру. Лечится сужением описания
— назовите условие, а не область.
В скилл уедет то, что модель знает и без вас. «Пиши понятный код»,
«соблюдай стиль» — вычёркивайте. В скилле должно остаться только ваше:
порядок, имена, места, критерии готовности.
Скилл вырастет в методичку. Держите основной файл коротким, подробности —
в соседних файлах, на которые он ссылается. Инструмент прочитает их, когда
понадобится.
Он устареет молча. Скилл, описывающий процедуру, ломается при первой же
смене процедуры — и, в отличие от кода, ничего не падает. Дата последней
проверки в конце файла спасает.