Что такое 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 и скрипты.

Связанные термины

Все термины

Посмотрите, как это работает.

Скачайте AgentVera бесплатно, добавьте папку проекта и запускайте Claude Code, Codex и других агентов рядом друг с другом.