Расширьте возможности режима агента с помощью навыков.

Навыки позволяют расширить возможности режима агента, добавив специализированные знания и настраиваемые рабочие процессы. Они основаны на открытом стандарте Agent Skills .

В отличие от файлов AGENTS.md , навыки представляют собой экспертные знания, предоставляемые по запросу. Такая структура позволяет режиму агента поддерживать большое количество специализированных возможностей — таких как миграция между определенными версиями библиотеки или адаптация составного элемента к различным размерам экрана — без загромождения контекстного окна модели.

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

Чтобы активировать навык по запросу, попросите агента выполнить задачу, соответствующую этому навыку. Вы также можете ввести @ в поле ввода, чтобы запустить конкретный навык.

Основные преимущества

  • Обмен опытом: Сложности рабочих процессов (например, процесс проверки запросов на слияние в конкретной команде) можно объединить в отдельную папку, доступную для всех.
  • Повторяемые рабочие процессы: Обеспечьте единообразное выполнение сложных многоэтапных задач, предоставив стандартные инструкции.
  • Объединение ресурсов: включите скрипты, шаблоны или примеры данных вместе с инструкциями, чтобы у агента было все необходимое в одном месте.
  • Эффективное использование контекстного окна: для сохранения контекстных токенов изначально загружаются только метаданные навыка (имя и описание). Полный файл SKILL.md загружается только при активации. Вспомогательные файлы в каталогах references/ , scripts/ или assets/ загружаются в контекст только тогда, когда агенту они необходимы.

Создавайте собственные навыки

Агент ищет навыки, начиная с каталогов .skills/ или .agent/skills/ расположенных в корневой директории вашего проекта. Чтобы создать собственный навык, выполните следующие шаги:

  1. Создайте директорию для вашего навыка (например, my-new-skill/ ).
  2. Создайте файл SKILL.md (с учетом регистра) в новой директории.

Навыки должны соответствовать следующим правилам:

  • Для каждого навыка требуется отдельная директория: каждый навык должен иметь свою уникальную директорию, содержащую файл SKILL.md и любые дополнительные ресурсы .
  • Вложенность: Все навыки должны находиться в каталоге .skills/ или .agent/skills/ в корне проекта. Однако для лучшей организации можно использовать подкаталоги (например, skills/ui-flows/<skill name>/SKILL.md или skills/testing/<skill name>/SKILL.md ).
  • Область применения: В настоящее время поддерживаются только навыки, встроенные в кодовую базу проекта.

В файле SKILL.md для метаданных используется блок YAML, а для инструкций — стандартный Markdown.

  • name : Уникальный идентификатор навыка. Он должен совпадать с именем каталога.
  • description : Четкое объяснение того, что делает навык и когда агент должен его использовать.
  • Тело сообщения: Вложенный текст Markdown, расположенный под блоком YAML, содержит инструкции, определяющие поведение агента при активации навыка. 
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

Рекомендации по форматированию

  • Имя: Максимум 64 символа (только строчные буквы, цифры и дефисы).
  • Описание: Максимальное количество символов — 1024.
  • Основной текст: стремитесь к объему в 10–20 тысяч символов (примерно 2500–5000 токенов). Если ваши инструкции превышают этот объем, рассмотрите возможность переноса подробной документации в файл ресурсов, как описано в разделе «Дополнительные каталоги навыков» .

Дополнительные каталоги навыков

Чтобы файл SKILL.md оставался лаконичным и модульным, вы можете включить дополнительные ресурсы в следующие необязательные каталоги внутри папки вашего навыка:

  • scripts/ : Содержит исполняемый код (например, Python или Bash), который может запустить агент.
  • references/ : Содержит подробную техническую документацию, справочники по API или руководства по конкретным областям.
  • assets/ : Содержит статические ресурсы, такие как шаблоны документов, диаграммы пользовательского интерфейса или JSON-схемы.

При указании этих файлов в инструкциях SKILL.md используйте относительные пути от корневой директории навыка. Например: Run the script at scripts/cleanup.py .