Что такое Agent Skills?
Agent Skills (навыки агента) — это папки с инструкциями, скриптами и справочными файлами, которые учат агента выполнять определённую работу. Каждый навык строится вокруг файла SKILL.md, а агент загружает навык только тогда, когда этого требует текущая задача.
Как устроен навык
Навык — это папка с его именем. В YAML-frontmatter файла SKILL.md лежат поля name и description, а в теле — пошаговые инструкции. В папке могут быть также скрипты, шаблоны или справочные документы.
- В Claude Code личные навыки лежат в ~/.claude/skills/, а навыки проекта — в .claude/skills/.
- Codex тоже поддерживает навыки: навыки проекта лежат в .agents/skills, личные — в ~/.codex/skills.
- Навыки могут поставляться и вместе с плагинами.
Почему навыки загружаются постепенно
Вначале в контекст модели попадают только имя и краткое описание каждого навыка. Когда задача подходит под навык, модель читает полный SKILL.md и, при необходимости, файлы рядом с ним. Так контекст остаётся небольшим даже при десятках установленных навыков, но навык с расплывчатым описанием не сработает в нужный момент.
Навыки, MCP, субагенты и хуки
Эти четыре понятия часто путают; каждое решает свою задачу.
- Навык: знания и скрипты для работы; модель сама решает, когда его применять.
- MCP: добавляет новые инструменты и подключения к внешним сервисам.
- Субагент: вспомогательный агент, который работает в отдельном контексте.
- Хук: команда, которая выполняется при данном событии каждый раз, независимо от модели.
Как написать хороший навык
Навык полезен лишь настолько, насколько он срабатывает вовремя и остаётся коротким.
- В description ясно напишите, что делает навык и когда его использовать.
- Держите SKILL.md коротким, а длинные справочные материалы выносите в отдельные файлы.
- Повторяющиеся точные шаги оформляйте в скрипты, чтобы модель не переписывала их каждый раз.
- Читайте чужие навыки перед установкой; их скрипты выполняются на вашем компьютере.
Навыки в AgentVera
Галерея навыков AgentVera собирает навыки Claude Code и Codex с вашего компьютера в один список, а профили контекста позволяют управлять тем, сколько навыки добавляют к первому запросу.
- Details → Automation → Skills: создавайте, включайте, отключайте, редактируйте навыки Claude Code и Codex или копируйте их другому агенту.
- У навыков, установленных из галереи, файлы проверяются по SHA-256 и сканируются на вашем компьютере перед установкой; скрипты никогда не делаются исполняемыми.
- Публикация собственных навыков для вашей организации или в публичной галерее доступна в планах Pro и Team; публичные навыки проходят одобрение модератора.
- Профиль Lean context отключает пользовательские плагины, хуки, навыки и внешние MCP, сокращая первый запрос Claude Code примерно с 34,4k до 13,3k токенов.
FAQ
Чем навык отличается от MCP?
MCP даёт агенту новые инструменты и подключения; навык учит его, как выполнять работу. Навык может даже описывать, как пользоваться инструментами MCP.
Расходуют ли навыки токены в каждом запросе?
В контексте каждого запроса находятся только их имена и описания. Полное содержимое загружается, когда модель решает применить навык.
Как заставить агента использовать навык?
Обычно ничего делать не нужно; модель загружает навык, когда задача подходит под его описание. Можно также назвать навык по имени в сообщении и попросить агента его использовать.
Безопасно ли устанавливать чужой навык?
Зависит от содержимого. В навыках есть инструкции и скрипты, а скрипты выполняются на вашем компьютере. Перед установкой прочитайте SKILL.md и скрипты.