Скилы (skills)
Модель знает «всё вообще»: как пишут код-ревью в среднем по индустрии, как обычно оформляют баг-репорты, как принято делать релизы. Но она не знает, как это делаете вы: что у вашей команды ревью начинается с проверки миграций, что баг-репорт без шагов воспроизведения возвращается автору, что релиз в пятницу запрещён регламентом. Скилы (skills) закрывают этот разрыв.
Что такое скил
Заголовок раздела «Что такое скил»Скил упаковывает инструкцию или процедуру, которую агент подгружает, когда задача её требует. По сути это документ «как у нас делается X», написанный для агента, а не для человека, и подключённый к харнесу (agent harness).
Открытый формат Agent Skills описывает папку с SKILL.md: обязательные поля name и description в YAML перед телом Markdown, а рядом могут находиться скрипты, справочники и шаблоны. Поддержка дополнительных полей и расположение папок зависят от харнеса. У инструкции две части:
- Описание-триггер. Короткая аннотация: что этот скил умеет и когда его применять. Например: «Регламент подготовки релиза. Используй, когда просят собрать релиз, подготовить changelog или выкатить версию».
- Тело. Сама процедура: шаги, правила, шаблоны, примеры. Рядом со скилом могут лежать вспомогательные файлы: шаблоны документов, скрипты, примеры «как надо».
Стандарт передан в Agentic AI Foundation под эгидой Linux Foundation. Открытый формат помогает переносить процедуру между инструментами. Перед переносом проверьте условия подгрузки, доступные команды и права: одинаковый SKILL.md не гарантирует одинакового выполнения.
Работает это так: харнес показывает модели только описания всех доступных скилов: несколько строк на каждый. Когда приходит задача «подготовь релиз 2.4», модель по описанию понимает, что есть подходящий скил, и подгружает его целиком. Дальше она следует вашей процедуре, а не «средней по интернету».
Прогрессивная подгрузка: почему скилы дёшевы
Заголовок раздела «Прогрессивная подгрузка: почему скилы дёшевы»Полная процедура загружается по необходимости; название и описание скила могут занимать контекст ещё до вызова.
Контекстное окно (context window) остаётся дефицитным ресурсом: всё, что в него положено, конкурирует за внимание модели с самой задачей. Если бы все регламенты команды постоянно висели в контексте, десять подробных процедур съели бы заметную его часть, притом что в конкретной сессии обычно нужна одна из них или ни одной.
Скилы решают это прогрессивной подгрузкой: в контексте постоянно живут только короткие описания-триггеры, а полное тело скила загружается по требованию. Каталог тоже имеет стоимость: десятки длинных похожих описаний мешают выбрать нужную процедуру. Оставляйте ясные условия применения и проверяйте срабатывание на типичных задачах.
Тот же приём разработчики харнесов применяют и к себе. Развёрнутые инструкции по проверке и код-ревью переезжают из системного промпта в скилы, а описания инструментов подгружаются по мере надобности вместо того, чтобы висеть в контексте с самого начала. Системный промпт от этого заметно худеет, а качество не падает.
Примеры скилов для команды
Заголовок раздела «Примеры скилов для команды»В скилы годится любая процедура, которую вы объясняете новому сотруднику. Несколько типичных примеров:
- «Наш процесс код-ревью». Что проверять в первую очередь, какие замечания блокирующие, в каком тоне писать комментарии, чек-лист для миграций и изменений API. Агент-ревьюер с таким скилом проверяет то, что важно вам, а не абстрактный «чистый код».
- «Шаблон постановки задачи». Обязательные секции: контекст, критерии приёмки, ограничения. Агент, помогающий аналитику, выдаёт задачи сразу в формате команды.
- «Регламент релиза». Последовательность шагов, правила версионирования, формат changelog, кого уведомить, что проверить перед выкаткой и в каком случае остановиться.
- «Стиль баг-репорта». Структура: шаги воспроизведения, ожидаемое и фактическое поведение, окружение, серьёзность. Тестировщик получает от агента черновики отчётов, которые не стыдно отправлять как есть.
Заметьте: половина примеров не про код. Скилы одинаково полезны разработчику, аналитику, менеджеру и тестировщику, везде, где есть повторяемая процедура с известными правилами.
Скилы, системный промпт, память: что куда класть
Заголовок раздела «Скилы, системный промпт, память: что куда класть»У агента несколько мест для инструкций, и их легко перепутать. Ориентир такой:
- Системный промпт задаёт харнес: это его зона ответственности, и трогать её обычно не нужно. Пользовательские правила уровня «всегда и везде» чаще всего живут не здесь, а в памяти.
- Память (Память). То, что должно быть в голове агента в каждой сессии этого проекта: команды сборки и тестов, архитектурные соглашения, стиль кода, запреты. Короткие факты, нужные постоянно.
- Скилы. Процедуры, нужные иногда: подробные пошаговые регламенты, которые применяются к определённому типу задач. Длинные инструкции, нужные по случаю.
Практическое правило: факт, нужный всегда, держите в памяти; процедуру, нужную иногда, выносите в скил. Если положить длинный регламент релиза в память, он будет занимать контекст в каждой сессии, включая те, где вы просто чините тест. Если, наоборот, спрятать в скил команду запуска тестов, агент не увидит её в обычной работе.
Скилы как командный актив
Заголовок раздела «Скилы как командный актив»Минимальный пример SKILL.md для папки review-migrations:
---name: review-migrationsdescription: Проверка миграций БД перед ревью изменений.---Прочитайте миграцию и связанные обращения к таблицам.Проверьте совместимость старой и новой версии приложения.Отдельно укажите блокировки, потерю данных и способ отката.Не выполняйте миграцию. Верните замечания с путями к файлам.Проверьте процедуру на задаче, где она нужна, на похожей задаче, где не нужна, и на случае с недостающими данными. Сравните результат с работой без скила по одной рубрике; подробная методика приведена в главе про эвалы.
Пока инструкции агенту живут в голове одного человека и его личных промптах, качество работы агента у каждого своё. Скилы позволяют превратить это в общий актив: папка со скилами лежит в репозитории, проходит ревью, версионируется и достаётся каждому, включая новых сотрудников и облачных агентов в CI.
Это тот же сдвиг, что когда-то произошёл с инфраструктурой: от «настроено руками у сисадмина» к «описано кодом в репозитории». Знание «как у нас принято» перестаёт быть устным преданием и становится файлом, который можно улучшать.
Что дальше
Заголовок раздела «Что дальше»- Память: что агент должен знать в каждой сессии.
- Контекст-инжиниринг: как управлять контекстом агента в целом.