Стандарт Agent Skills: как создать ИИ-агента, который открывает SKILL.md только по задаче

Инструкция по сверке акта с договором жила у нас сразу в трёх местах: в системном тексте агента, в комментарии к сценарию и в переписке с аналитиком. Какая копия свежая, к сдаче уже не помнил никто. 22 октября 2026 Anthropic отдала стандарт Agent Skills в Agentic AI Foundation при Linux Foundation: вместе с ним уходят имя, сайт agentskills.io и организация на GitHub. Процедура лежит в своей папке и попадает в диалог только если задача совпала с коротким описанием. Тем, кто собирает ИИ-агенты для бизнеса, больше не нужно копировать одну и ту же инструкцию в каждого нового агента.

ИИ-агент что это, если регламент не зашит в модель

На первой встрече просят "просто объяснить, что это". Короткий ответ такой. ИИ-агент - не окно чата с ролью "ты бухгалтер". Это модель, набор инструментов и процедура, которую можно не открывать.

При старте агент видит только имя навыка и описание. Тело SKILL.md он читает позже, когда задача с описанием совпала. Вопрос про статус поставки не тянет за собой сверку акта. Вопрос про расхождение сумм - тянет.

Пока всё сидело в одном тексте, агент таскал чужие регламенты в каждый диалог. Первый подход, "дописать в инструкцию ещё абзац", из-за этого и раздувал контекст. Файл, который открывается только по совпадению, сработал там, где общий текст уже мешал.

Как собрать файл, а не ещё одного агента

Создание ИИ-агента в эту сторону начинается с каталога, не с выбора модели. Имя каталога совпадает с полем name: строчные латинские буквы, цифры и дефисы, не длиннее 64 символов.

Мы завели act-reconcile и положили в него SKILL.md. В шапке два обязательных поля. name - то же act-reconcile. description - до 1024 символов, и там не название отдела, а слова задачи: сверить акт с договором и спецификацией, когда в сообщении есть акт, УПД, закрывающие документы или расхождение сумм.

Тело спецификация советует держать короче 500 строк. У нас там шаги, пример входа и запреты. Пример входа - номер договора, дата, сумма, таблица позиций. Запреты короткие: не писать контрагенту, не ставить в учёте отметку о сверке, не выдумывать спецификацию, которой нет во вложении.

Дальше одна команда: skills-ref validate ./act-reconcile. И одна узкая задача, не "наведи порядок в документах". Если агент открыл навык на вопросе про график отпусков, описание широкое. Сужать надо его, а не дописывать запрет в общий текст.

Платформа ещё без Skills - не повод откладывать. В постоянной инструкции оставьте имя и описание, полный текст отдавайте отдельным чтением файла, когда описание совпало. Поля те же, только загрузку пока делаете вы, а не среда, которая умеет стандарт.

Где ломается уже на второй платформе

Куда класть каталог, стандарт не говорит. У одного продукта это папка проекта, у другого - домашний каталог пользователя. Файл "просто рядом с кодом" агент может не заметить.

allowed-tools - поле экспериментальное, поддержка разная. По спецификации конкретный агент имеет право его проигнорировать. Список вызовов мы поэтому держим в коде контура. Шапка файла этот список не заменяет и не расширяет.

Каталог scripts/ исполняет сам агент. Руководства по безопасности у стандарта ещё нет. В дорожной карте, которую только предложили, рядом стоят версионированные релизы, формальный процесс предложений и это руководство. Пока его нет, навык со скриптом мы не включаем, пока человек скрипт не прочитал. В фонд ради этого вступать не нужно: ни чтобы пользоваться форматом, ни чтобы прислать правку.

Как только навык сработал, в диалог приезжает весь текст файла, а не абзац по теме вопроса. Выигрыш на пустых диалогах легко проиграть на единственном нужном. Не влезло в 500 строк - это уже несколько навыков. Резать по задаче, не по главам регламента.

С публикации стандарта в декабре 2025 его, по данным Anthropic, подключили больше 70 платформ, в том числе ChatGPT, Cursor, GitHub Copilot и VS Code. Общий формат не означает общий путь установки и общий набор инструментов. Навык, который ожил в одном окне, во втором надо проверять заново.

Что оставить включённым, даже если Skills уже есть

В всегда работающей инструкции - только то, без чего агент не выберет навык. Фразы вида "открой акт, сравни сумму, покажи строки" в этот текст больше не кладём.

Описание пишем языком входящего сообщения. "Для бухгалтерии" ни с чем не совпадёт. "Акт, УПД, расхождение сумм" - совпадёт.

Инструменты решаются отдельно от файла. Если платформа поле allowed-tools не читает, притворяться, что прочитали, опаснее, чем не писать его вовсе.

Файл не выбирает модель. Он только решает, когда читать процедуру. Облако это, локальный запуск или контур под 152-ФЗ - вопрос контура, не шапки YAML. На российском контуре тот же каталог нормально ложится рядом с уже принятой моделью: формат вендора модели не требует.

Новый регламент у нас больше не повод заводить нового агента. Новый регламент - новый каталог. Агент остаётся тем же, пока хватает инструментов.

Если текст, который вы вставляете в каждого агента, не помещается в имя, описание и пятьсот строк, заводить ещё одного рано. Сначала разрежьте процедуру. Иначе через месяц снова три копии, и ни одна не свежая.

Какой регламент вы до сих пор копируете целиком - и узнает ли его агент по одним словам описания?

Стандарт Agent Skills: как создать ИИ-агента, который открывает SKILL.md только по задаче

ИИ-агент что это, если регламент не зашит в модель

Как собрать файл, а не ещё одного агента

Где ломается уже на второй платформе

Что оставить включённым, даже если Skills уже есть

Похожие статьи

Обсудим, как это внедрить у вас