Что такое навык агента

Навык — это папка с инструкцией, которую агент подхватывает сам, когда задача совпадает. Разбираем, как он устроен, где лежит и что проверить перед установкой.

Технически это файл SKILL.md с короткой шапкой и текстом инструкции. В шапке два обязательных поля: name (до 64 символов, строчные буквы, цифры и дефисы) и description (до 1024 символов). Описание — главное: именно по нему агент решает, когда навык включать. Поэтому в нём пишут и что навык делает, и когда его применять. По документации Anthropic, ноябрь 2026.

Как это работает по шагам

Всё построено на постепенной загрузке, чтобы не занимать контекст заранее. Уровней три.

При запуске агент видит только имя и описание навыка — примерно сто токенов на навык. Поэтому навыков может быть много: пока они не нужны, они почти ничего не стоят.

Когда запрос совпал с описанием, агент читает SKILL.md целиком. Это обычно меньше пяти тысяч токенов: порядок действий, правила, примеры.

Если в инструкции есть ссылки на другие файлы — справочники, схемы, шаблоны, скрипты — агент открывает их только при необходимости. Скрипт он запускает, а в контекст попадает лишь результат, а не код.

Где лежит навык

В Claude Code навыки берут из двух мест: ~/.claude/skills/ — личные, для всех проектов, и .claude/skills/ — проектные, только для этого репозитория. В claude.ai навык загружают архивом, в API — через отдельный интерфейс. Кастомные навыки не синхронизируются между продуктами: загруженный в одном месте не появится в другом автоматически.

Что внутри бывает

Инструкции — обычный текст с шагами и правилами. Скрипты — небольшие программы, которые агент запускает, не читая их в контекст. Справочники — таблицы, схемы, примеры, которые нужны редко и не всегда целиком.

Чем навык не является

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

Перед установкой чужого навыка

Навык даёт агенту новые указания и доступ к тому, что агент умеет: файлы, команды, сеть. Поэтому чужой навык — это как чужой скрипт.

Прочитайте все файлы, а не только описание. Ищите сетевые вызовы, обращения к домашней папке, команды, которые не связаны с заявленной задачей. Сверьте описание с тем, что навык реально делает. Проверьте, живой ли репозиторий и кто автор.

Документация Anthropic отдельно предупреждает: недоверенные навыки могут уводить данные, выполнять лишние команды и обращаться к внешним адресам. Навык, который тянет данные из интернета, опаснее обычного: в полученном тексте могут быть инструкции для агента.

Что важно знать про ограничения

В API навыки работают в песочнице без сети и без установки пакетов. В Claude Code сеть есть — как у любой программы на вашем компьютере. Предустановленные навыки для документов (PowerPoint, Excel, Word, PDF) в Claude Code недоступны, хотя в claude.ai и API они есть.

Как выбрать навык под задачу

Смотрите не на название, а на описание: в нём должно быть сказано, что навык делает и когда его включать. Если описание размытое, агент будет включать навык не там — или не включит вовсе. Дальше смотрите на состав: только текст — безопаснее, скрипты и сеть — требуют проверки.

Наши разборы навыков и обвязок лежат на полках: тема «Агенты» и метка «Claude». В каждом материале есть ссылка на оригинал, лицензия и дата последнего обновления проекта — на день разбора.