Что такое Skills простыми словами
Skill — это подключаемый набор инструкций и файлов, который описывает Claude, как выполнять конкретный тип работы. Условно: вместо того чтобы каждый раз объяснять модели ваш регламент код-ревью, вы один раз оформляете его как навык, и дальше модель подхватывает его сама, когда задача подходит под описание.
Ключевое отличие от обычного длинного системного промпта — экономия контекста и избирательность. Навык подгружается тогда, когда он релевантен задаче, а не висит в каждом запросе. Для больших наборов правил это принципиально: постоянно держать их в контексте дорого и вредно для качества.
- Навык описывает процесс: как делать, в каком порядке, с какими проверками.
- Подключается по релевантности, а не на каждый запрос.
- Может нести с собой файлы: шаблоны, схемы, вспомогательные скрипты.
Как устроен скилл изнутри
Технически скилл — это папка с описательным файлом и, при необходимости, дополнительными материалами. В описательном файле указывается имя, короткое описание того, когда навык применять, и сами инструкции. Именно по описанию модель решает, стоит ли подгружать навык под текущую задачу — поэтому формулировать его надо в терминах триггеров, а не абстрактной пользы.
Дополнительные материалы — это то, что отличает навык от заметки: шаблоны документов, справочные таблицы, примеры правильного и неправильного результата, скрипты, которые модель может выполнить в песочнице.
- Описание навыка должно отвечать на вопрос «когда его применять».
- Инструкции — пошаговые, с явными критериями готовности.
- Приложенные файлы подгружаются по мере необходимости, а не целиком.
Skills в Claude Code и в API
В Claude Code навыки — это способ зафиксировать командные соглашения: стиль коммитов, порядок прогона тестов, чек-лист перед релизом, правила работы с миграциями. Один раз описали — и агент следует им во всех сессиях, а не только когда вы вспомнили напомнить.
В API навыки подключаются к запросу вместе с инструментом исполнения кода: модель получает доступ к материалам навыка в песочнице и может, например, собрать документ по вашему шаблону. Это отдельная бета-функциональность со своими заголовками — если вы строите на ней продукт, сверяйтесь с актуальной документацией Anthropic, набор флагов периодически меняется.
- Claude Code: командные регламенты, чек-листы, повторяющиеся процессы.
- API: генерация документов по шаблону, воспроизводимые процедуры обработки.
- И там, и там навык остаётся текстом плюс файлами — его легко версионировать в git.
Skills, MCP и промпт: что когда использовать
Эти три механизма часто путают, хотя решают они разные задачи. Промпт задаёт поведение здесь и сейчас. Навык описывает процесс и подключается по релевантности. MCP-сервер даёт доступ к внешним данным и системам — базе, трекеру, файловому хранилищу.
На практике они комбинируются: MCP приносит данные, навык описывает, что с ними делать, промпт формулирует конкретную задачу. Ошибка новичка — пытаться заменить одно другим: например, запихнуть в системный промпт трёхстраничный регламент, который стоило оформить навыком, или описывать словами то, что нужно просто прочитать из базы через MCP.
| Механизм | Что решает | Когда брать |
|---|---|---|
| Промпт | Постановка конкретной задачи | Всегда, это базовый уровень |
| Skill | Повторяемый процесс и регламент | Правила применяются регулярно и объёмны |
| MCP | Доступ к внешним данным и системам | Нужны живые данные из вашей инфраструктуры |
С чего начать
Хороший первый навык — тот процесс, который вы объясняете модели чаще всего. Посмотрите на свою переписку с Claude за последнюю неделю: то, что повторяется в трёх и более задачах, и есть кандидат.
Начните с малого: имя, точное описание триггера, пять-семь шагов инструкции и один пример правильного результата. Раздувать навык сразу не нужно — расширяйте его тогда, когда видите, что модель систематически ошибается в одном и том же месте.
- Шаг 1: найдите процесс, который объясняете повторно.
- Шаг 2: опишите триггер применения одной фразой.
- Шаг 3: разложите процесс на шаги с критериями готовности.
- Шаг 4: приложите пример эталонного результата.
Работают ли Skills через шлюз
Да. Шлюз передаёт запросы в формате Anthropic API без изменения структуры, поэтому всё, что относится к навыкам, инструментам и агентным режимам, работает так же, как при прямом подключении. Для Claude Code навыки лежат в вашем проекте локально — шлюз влияет только на то, куда уходит запрос к модели.