Навыки агентов — это повторно используемые пакеты инструкций и необязательных скриптов, справочных материалов и шаблонов, которые помогают ИИ-агенту выполнить конкретную задачу. В открытом формате Agent Skills каждый пакет представляет собой папку с файлом SKILL.md в основе. Совместимые агенты могут находить навыки и загружать их инструкции по мере необходимости, вместо того чтобы одновременно держать в контексте все процедуры. В этом руководстве объясняется формат, приводятся практические примеры и описывается создание и тестирование первого навыка.
Что такое навыки агентов?
Agent Skills — это лёгкий открытый формат для упаковки специализированных знаний и рабочих процессов. Навык содержит файл SKILL.md с метаданными YAML, в которых указаны его название и назначение, а затем инструкции в Markdown. Вспомогательные файлы могут включать скрипты, справочные документы и шаблоны.
Термин «навыки ИИ» может означать разные вещи, в том числе способность людей пользоваться ИИ. В этом руководстве под навыками агентов и навыками ИИ-агентов понимаются именно повторно используемые пакеты SKILL.md для совместимых агентов.
Например, навык для подготовки итогов встречи может определять разделы командного протокола, правила фиксации решений и порядок выделения отсутствующих ответственных или сроков. Эти правила сохраняются один раз и используются повторно с новыми заметками со встреч. Навык направляет работу агента, но не дообучает базовую модель.
Открытая спецификация требует указывать в метаданных имя и описание. Имя должно содержать от 1 до 64 символов, состоять из строчных букв, цифр и дефисов, совпадать с названием каталога; оно не может начинаться или заканчиваться дефисом либо содержать несколько дефисов подряд. Описание должно содержать от 1 до 1 024 символов и пояснять как задачу, так и случаи, когда следует использовать навык.
Как работают навыки агентов?
Формат разработан для постепенного раскрытия информации: агенты получают достаточно сведений, чтобы выбрать навык, прежде чем загрузить его полные инструкции.
Обнаружение. Агент получает названия и описания доступных навыков. Эти метаданные тоже занимают контекст, но все процедуры целиком заранее не загружаются.
Активация. Выбрав подходящий навык, агент читает SKILL.md. Некоторые инструменты также позволяют вызвать навык по имени или отключить автоматический выбор.
Выполнение. Агент следует процедуре, при необходимости читает вспомогательные материалы или запускает скрипты, если это разрешено.
Это сокращает объём контекста, занимаемый неактивными процедурами. Фактическое использование контекста зависит от количества и длины описаний, активных навыков и загруженных ресурсов. Чёткие описания помогают с выбором, но активацию и качество результатов всё равно нужно проверять.
Навыки агентов, prompt, MCP и инструменты
В терминологии ИИ-инструментов легко запутаться, а рядом с понятием «навык» есть несколько похожих концепций. Вот чем они отличаются:
| Возможность | Что это | Когда активно | Лучше всего подходит для |
|---|---|---|---|
| Промпт | Инструкции, передаваемые в ходе разговора; их также можно сохранить | Пока сохраняется в контексте разговора | Разовых инструкций |
| Постоянно действующие инструкции (например, AGENTS.md, QWEN.md) | Факты и ограничения проекта | Согласно области проекта агента и правилам загрузки | Правил для всего проекта |
| Навык агента | Версионируемая папка с инструкциями и ресурсами | Загружается по запросу, когда это необходимо | Повторяемых рабочих процессов и процедур |
| MCP-сервер / инструмент | Работающая интеграция, предоставляющая действия и данные | Когда настроен, подключён и имеет разрешения | Выполнения действий и доступа к актуальным данным |
| Субагент | Отдельный исполнитель с собственным контекстным окном | При запуске | Изолированной или параллельной работы |
Навыки и prompt. Prompt содержит инструкции в разговоре, а навык хранит повторно используемую процедуру и вспомогательные ресурсы для обнаружения или явного вызова. Prompt также можно сохранять и использовать повторно. Навык полезен, когда для повторяющейся задачи нужен поддерживаемый рабочий процесс, примеры, справочные материалы или скрипты.
Навыки и MCP. MCP предоставляет агенту возможности, то есть подключения к работающим инструментам и данным. Навык предоставляет агенту знания: как качественно выполнить задачу, в какой последовательности и с какими шагами проверки. Они дополняют друг друга. Навык для проверки кода определяет, что считается тщательной проверкой, а сервер GitHub MCP позволяет агенту прочитать сам пул-реквест.
Навыки и инструкции проекта. Файлы наподобие AGENTS.md содержат указания по проекту в рамках правил загрузки и области действия агента. Размещайте там общие соглашения, а навыки используйте для процедур конкретных задач, которые должны загружаться при необходимости. Точное поведение зависит от инструмента.
Почему навыки агентов важны
Повторно используемая экспертиза: сохраняйте методы, контрольные списки и шаблоны для конкретных задач, чтобы не объяснять их каждый раз.
Более единообразные процедуры: задавайте агентам одинаковые шаги и критерии проверки для повторяющихся задач. Результаты всё равно требуют проверки.
Эффективное использование контекста: загружайте подробные инструкции только при необходимости, а не включайте все процедуры в постоянно загружаемые указания.
Повторное использование в разных инструментах: используйте основной формат SKILL.md в совместимых агентах, предварительно проверяя доступ к инструментам, зависимости и поля, специфичные для платформы.
Поддержка командой: храните папки навыков в системе контроля версий, чтобы можно было проверять изменения общего рабочего процесса.
Какие инструменты ИИ поддерживают навыки агентов?
Навыки агентов поддерживает всё больше инструментов ИИ, включая Claude Code, OpenAI Codex, Cursor, GitHub Copilot и Kimi Code. Эти инструменты используют повторно используемые пакеты навыков, чтобы предоставлять агентам инструкции, рабочие процессы и вспомогательные ресурсы для конкретных задач.
Общий формат SKILL.md упрощает повторное использование навыков в совместимых инструментах, хотя пути установки и способы вызова различаются в зависимости от продукта. Если навык использует скрипты или внешние инструменты, убедитесь, что эти зависимости доступны в среде, где вы планируете его применять.
Примеры и сценарии использования навыков агентов
Полезный навык фиксирует правила, которые делают повторяющуюся задачу специфичной для вашей команды. Эти примеры показывают, что стоит включить в пакет и что проверить в результате:
| Навык | Входные данные | Повторно используемые правила | Проверяемый результат |
|---|---|---|---|
| Итоги встречи | Заметки или расшифровка встречи | Отделить решения от обсуждения; указать ответственных за задачи и сроки; отметить недостающие сведения | Протокол с разделами «Итоги», «Решения» и «Задачи» |
| Проверка брендового контента | Черновик и рекомендации по бренду | Проверьте утверждённую терминологию, тон, запрещённые заявления и обязательные формулировки | Список проблем с предлагаемыми правками |
| Проверка кода | Дифф pull request | Проверьте обработку ошибок, тесты, изменения зависимостей и соглашения проекта | Отчёт, в котором обязательные исправления отделены от рекомендаций |
| Еженедельный отчёт | Заметки о ходе работы и метрики | Используйте фиксированный отчётный период и разделы; отделяйте выполненную работу, риски и следующие шаги | Отчёт, сохраняющий предоставленные метрики и отмечающий отсутствующие данные |
Обработка документов и регулярный анализ данных также хорошо подходят для навыков, но часто требуют инструментов или скриптов помимо SKILL.md. Начните с узкого рабочего процесса, проверяйте его результаты и добавляйте зависимости только тогда, когда они нужны для задачи.
Использование навыков агентов с Kimi AI
Выберите среду, которая подходит для вашей задачи. Описанные выше способы создания охватывают подготовку на естественном языке и локальный файловый рабочий процесс.
Навыки агентов в Kimi Code
Kimi Code CLI обнаруживает навыки в каталогах проекта .agents/skills/ и .kimi-code/skills/, а также в пользовательских каталогах ~/.agents/skills/ и ~/.kimi-code/skills/. Каталог пользователя для Kimi можно изменить с помощью KIMI_CODE_HOME. Вызовите навык командой /skill:<name> либо позвольте модели выбрать его на основе описания и поддерживаемых полей триггеров. Автоматический выбор можно отключить для отдельных навыков. При настройке путей или полей, зависящих от платформы, сверяйтесь с актуальной документацией CLI.
Навыки агентов для повседневной работы в Kimi
Не нужно настраивать всё с нуля. Откройте Kimi на компьютере или в веб-версии, перейдите в магазин навыков и установите навык одним кликом, чтобы начать пользоваться им в Kimi. В магазине навыков Kimi есть навыки для самых разных задач — от исследований и написания текстов до программирования и анализа данных. Откройте магазин в настольном или веб-приложении Kimi, установите навык одним кликом и начните пользоваться им в Kimi.
Как создать собственный навык агента
Навык можно создать, описав рабочий процесс инструменту с ИИ или самостоятельно написав SKILL.md. Начните с одной повторяющейся задачи и результата, который легко проверить, например протокола встречи.
Способ 1: создать навык агента с помощью Kimi
В Kimi откройте панель навыков, чтобы найти или установить навыки. Чтобы создать собственный навык, загрузите процедуру или опишите нужный результат в диалоге по созданию навыка. Также можно воспользоваться командой /skill-creator. Актуальные точки входа описаны в руководстве Kimi по навыкам.
Шаг 1: Откройте магазин навыков Kimi и нажмите «настроить» > «Создать с Kimi».
Шаг 2: Опишите нужный вам навык.
Укажите Kimi задачу, ожидаемые входные данные, структуру результата и правила на случай нехватки информации.
Например:
Если в результате не учтено какое-либо правило, попросите Kimi исправить его и повторите проверку. Для существующей SOP укажите, какие части являются инструкциями, а какие — справочными материалами; перед упаковкой удалите нерелевантный или конфиденциальный контент. После создания навык можно сразу использовать в Kimi.
Способ 2: самостоятельное написание навыков агентов
В этом примере используются только текстовые инструкции, без дополнительных скриптов. Для демонстрации установки и вызова используется Kimi Code CLI; другие агенты могут использовать другие пути и команды.
Шаг 1: Создайте папку. Для навыка пользовательского уровня в Kimi Code CLI создайте ~/.agents/skills/meeting-summary/. Для навыка уровня репозитория, которым пользуется команда, используйте .agents/skills/meeting-summary/ в корневом каталоге репозитория.
Шаг 2: Сохраните SKILL.md. Создайте ~/.agents/skills/meeting-summary/SKILL.md и вставьте приведённый ниже текст. В описании определяется задача, а в основной части — формат результата и правила на случай нехватки информации.
Шаг 3: Начните новый сеанс и вызовите навык. После сохранения файла начните новый сеанс Kimi Code CLI. Введите эту команду в поле чата:
Шаг 4: Проверьте результат. Ниже приведён пример ожидаемого результата, а не записанный результат работы продукта. Формулировки могут отличаться, но разделы, решение, ответственные и сроки должны соответствовать навыку.
Шаг 5: Проверьте автоматический выбор и границы применения. В новом диалоге попросите: «Преврати эти заметки со встречи в протокол» — без команды со слешем — и предоставьте те же заметки. Проверьте, загружает ли агент навык по журналу активности в интерфейсе, если он доступен, и соответствует ли результат его правилам. Затем попробуйте несвязанный запрос, например «Объясни рекурсию в Python»: навык meeting-summary не должен активироваться. Также вызовите его без заметок: он должен запросить входные данные.
Что делать, если навык агента не работает?
| Симптом | Что проверить |
|---|---|
| Навык не обнаруживается | Проверьте каталог сканирования, точное имя файла SKILL.md, корректность YAML frontmatter и соответствие папки имени. После добавления начните новый сеанс. |
| Ручной вызов работает, но автоматический выбор — нет | Сделайте описание более конкретным для предполагаемой задачи. Проверьте, не отключён ли автоматический вызов; повторите попытку в новом диалоге. |
| Навык активируется для нерелевантных запросов | Сузьте описание и проверьте нерелевантные запросы как отрицательные примеры. |
| В результате пропущено правило | Сформулируйте правило явно, добавьте пример входных и выходных данных и повторно проверьте случаи с отсутствующей информацией. |
| Скрипт или интеграция не работают | Проверьте необходимые пакеты, разрешения, доступ к сети и настроенные инструменты. Навык не устанавливает все зависимости автоматически. |
Для скриптов, длинных справочных материалов или шаблонов при необходимости добавьте scripts/, references/ или assets/ и укажите на них ссылки из SKILL.md. Актуальные пути и варианты вызова описаны в документации по Skills для Kimi Code CLI.
Рекомендации по использованию и созданию навыков агентов
Чётко определите триггер: объясните и задачу, и случаи, когда следует использовать навык. Включите термины, которые пользователи употребляют естественно, и протестируйте релевантные и нерелевантные запросы.
Не перегружайте инструкции: спецификация рекомендует для основного файла менее 500 строк и менее 5 000 токенов. Это отдельные рекомендации, а не способ пересчитать строки в токены. Подробные справочные материалы вынесите во вспомогательные файлы.
Задавайте наблюдаемые результаты: укажите обязательные разделы, примеры входных данных и результатов, а также правила на случай нехватки информации.
Документируйте зависимости: укажите необходимые инструменты и пакеты и при необходимости используйте метаданные совместимости. Расширения, зависящие от платформы, храните отдельно от переносимого ядра.
Контролируйте значимые действия: для рабочих процессов, которые отправляют сообщения или развёртывают изменения, используйте явный вызов и подходящие правила подтверждения. Ручной вызов сам по себе не заменяет проверки разрешений.
Проверяйте сторонние пакеты: перед установкой изучите инструкции и входящие в состав скрипты, включая используемые ими данные и разрешения.
Заключение
Навыки агентов превращают повторяющиеся задачи в многократно используемые рабочие процессы, которые совместимые агенты с ИИ могут загружать при необходимости. Начните с чёткого SKILL.md, в котором указано, когда использовать навык и какой результат он должен выдавать. Добавляйте скрипты или справочные материалы только тогда, когда этого требует задача, затем проверяйте условия активации навыка и качество его результата.