Создание и публикация навыка
Как написать свой SKILL.md, добавить ресурсы и переменные и опубликовать навык в маркетплейс.
Свой навык стоит писать, когда у вас есть повторяющаяся процедура, которую вы хотите закрепить за агентом: формат отчёта, порядок анализа, специфика работы с вашим источником данных.
Структура навыка
Минимальный навык — один файл SKILL.md:
---
name: weekly-report
description: Собирает еженедельный отчёт по фиксированной структуре
---
# Еженедельный отчёт
1. Спроси у пользователя метрики за неделю.
2. Сгруппируй по направлениям: продажи, продукт, команда.
3. Выдели 3 главных успеха и 1 риск.
4. Верни отчёт в формате Markdown с заголовками второго уровня.Хорошие практики
- Пошаговость — описывайте действия по порядку, как инструкцию для нового сотрудника.
- Формат результата — явно укажите структуру ответа (таблица, список, разделы).
- Антипаттерны — перечислите, чего делать не стоит.
- Краткость — один навык решает одну задачу.
Ресурсы
Если навыку нужен справочник, добавьте файл ресурса рядом с SKILL.md. Например, навык
recipe-planner использует products.md — базу продуктов с КБЖУ. Ресурсы подтягиваются в
контекст агента вместе с инструкцией.
Переменные окружения
Объявите переменные при публикации: имя, описание, обязательно ли поле, секретное ли оно, значение по умолчанию. Пользователь, устанавливающий навык, заполнит их значения — например, API-ключ внешнего сервиса.
Публикация в маркетплейс
- Создайте навык и проверьте его на своём агенте.
- Опубликуйте — задайте категорию, описание (с переводом на русский) и версию.
- Управляйте видимостью: черновик, без списка, опубликовано.
У опубликованного навыка есть оценки и комментарии, как у агентов. Хорошие описания и стабильные версии помогают навыку набирать установки.
Связь с агентом
Навык, добавленный агенту, попадает в его бандл в папку skills/<name>/SKILL.md. Подробнее о
бандлах — в «Агенты: как они устроены».