Скилы против Rules / AGENTS.md✦
Два инструмента, а не один✦
В докладе про скилы (Сергей Будяев, Яндекс) прямо разводятся две концепции, которые часто путают. Rules / AGENTS.md грузятся всегда, вне зависимости от контекста, и хранят статическую информацию, нужную агенту постоянно — например, как устроен проект, какие в нём конвенции. Это «просто текст», без хитрой структуры.
Скилы срабатывают ситуативно, по триггеру. Код-ревью мы делаем не каждую
минуту, релизноты пишем не постоянно — такие сценарии и выносятся в скил,
который подгружается только когда нужен. У скила более «разухабистая»
структура: инструкция SKILL.md, плюс скрипты, картинки, конфиги, шаблоны в
одной папке.
Главный тезис контрибьютора: это дополняющие, а не взаимозаменяемые инструменты. Был период «давайте всё скелизуем» — и он оказался ошибочным.
Механика подтверждается документацией Anthropic: скил — это папка с
обязательным SKILL.md (YAML-фронтматтер name + description и тело
инструкции), а загрузка идёт прогрессивно в три уровня — метаданные
(~100 токенов на скил) подгружаются всегда, тело SKILL.md (<5k токенов) —
при срабатывании триггера, ресурсы — по необходимости. AGENTS.md, в свою
очередь, — открытый стандарт («README для агентов»), обычный markdown,
поддерживаемый 20+ инструментами (Codex, Cursor, Copilot, Jules и др.) под
эгидой Agentic AI Foundation.
Замер Vercel: для нового API победил AGENTS.md✦
Контрибьютор ссылается на исследование коллег из Vercel. Они разрабатывали новую версию API (фреймворк Next.js 16), с которой агент по определению ещё не умеет работать, и сначала решили сложить весь этот контекст в скилы. Замеры показали, что со скилами получалось заметно хуже — агент просто не всегда вызывает скил. В итоге команда переложила контекст в AGENTS.md, и стало сильно лучше.
Точные цифры из статьи Vercel: базовый прогон без документации — 53%, скил по умолчанию — те же 53% (нулевой прирост), скил с явными инструкциями — 79%, а сжатый индекс в AGENTS.md — 100%. Ключевая причина провала скилов: в 56% случаев скил вообще не вызывался. При этом Vercel не хоронит скилы — они выигрывают на «вертикальных», явно запускаемых пользователем сценариях (апгрейд версии, миграция), тогда как для общего знания о фреймворке лучше работает пассивный, всегда доступный контекст.
Вывод✦
Скилы и Rules/AGENTS.md решают разные задачи: скилы — ситуативные сценарии, Rules/AGENTS.md — статическое знание, нужное всегда. Кейс Vercel — наглядная иллюстрация: если контекст должен применяться постоянно, на триггер скила полагаться не стоит.