Claude Code Skills: как создать свой скилл
Skill это инструкция, которую Claude Code подгружает по запросу: шаблон ревью, чеклист деплоя, конвенция по тестам. Когда задача подходит, агент сам открывает нужный скилл и действует по нему. Свои skills живут в .claude/skills как папка с файлом SKILL.md.
Чем skill отличается от CLAUDE.md
CLAUDE.md летит в каждый запрос всегда. Skill подгружается только когда он нужен. Так в контексте не висят тяжёлые инструкции на тысячи токенов, они приходят точечно под задачу.
Структура skill
.claude/skills/
└── pr-review/
└── SKILL.md
Сам файл:
--- name: pr-review description: Ревью пулл-реквеста. Используй, когда просят проверить PR или код перед мержем. --- Чеклист ревью: 1. Понять, что делает PR, по описанию и диффу. 2. Проверить типы и обработку ошибок. 3. Найти побочные эффекты и нетронутые тесты. 4. Вернуть замечания списком по убыванию важности.
Описание в фронте решает, когда Claude Code позовёт скилл. Чем точнее триггер, тем меньше ложных вызовов.
Когда skills полезны
| Случай | Стоит ли skill |
|---|---|
| Повторяющийся чеклист (ревью, деплой, релиз) | да |
| Конвенция по тестам или кодстайлу | да |
| Шаблон ответа на типовой запрос | да |
| Одноразовое правило под задачу | нет, лучше в CLAUDE.md |
| Длинная документация, которая нужна редко | да, чтобы не висела в контексте |
Частые ошибки
- Размытое description: скилл зовётся слишком часто или никогда.
- Слишком длинный SKILL.md: при вызове съедает контекст, ради чего и уходили от CLAUDE.md.
- Пересечение с CLAUDE.md: одно и то же правило в двух местах расходится.
Skills окупаются сильнее, когда токены стоят денег, а не абстрактного лимита. CLOD подключает Opus 4.8 и Sonnet 4.6 с оплатой рублём.
Частые вопросы
Skills встроены или я создаю их сам?
И то и другое. Claude Code умеет работать со skills, а контент вы задаёте сами в .claude/skills. Чужие скиллы тоже можно ставить из репозиториев.
Чем skill хуже обычной заметки в CLAUDE.md?
Тем, что он подгружается точечно, а не висит в каждом запросе. Для редких и тяжёлых инструкций skill экономит контекст.
Сколько skills можно завести?
Сколько угодно. Практично держать 5-10 под типовые задачи. Больше начинает путать выбор.
Skills работают на любой модели?
Да, это механизм инструкций. Точность вызова выше на Opus 4.8, экономичнее на Sonnet 4.6.