AGENTS.md загружается агентом целиком при каждом обращении к проекту. SKILL.md — только когда задача реально совпала с его описанием. Разница в экономике контекста прямая: чем крупнее AGENTS.md, тем больше токенов уходит впустую на задачах, где половина содержимого файла попросту не нужна.
Три признака кандидата на вынос
Императивная пошаговая структура — секция, которая читается как инструкция “сначала сделай это, потом то”, а не как общий принцип, обычно описывает конкретную процедуру, а не универсальное правило.
## Deploying to staging
1. Run npm run build
2. Copy dist/ to the staging server via rsync
3. Restart the systemd service
4. Check /health endpoint returns 200Такая секция — классический кандидат на SKILL.md: она понадобится не в каждой задаче, а конкретно тогда, когда речь идёт о деплое в staging.
Сравнение общего правила и процедуры-кандидата
| Признак | Общее правило (остаётся в AGENTS.md) | Процедура (кандидат на SKILL.md) |
|---|---|---|
| Частота применения | Почти в каждой задаче | В узком, специфичном сценарии |
| Форма изложения | Декларативное правило | Императивная последовательность шагов |
| Пример | “Используй TypeScript strict mode” | “Как развернуть staging-окружение” |
Что происходит, если не разбивать вовремя
AGENTS.md растёт линейно с каждой добавленной процедурой, и рано или поздно каждая задача — даже простое исправление опечатки в README — начинает тянуть за собой полный набор инструкций по деплою, миграциям и настройке CI, которые для этой конкретной задачи совершенно не нужны.
Важная оговорка про description у выделенной skill
Просто вынести процедуру в отдельный SKILL.md недостаточно — если description слишком расплывчатое, агент не сопоставит его с реальной задачей на этапе первичного сканирования, и skill фактически не будет вызываться, когда она нужна. Описание должно явно называть сценарий применения, а не быть общей фразой.
Как проверить свой AGENTS.md на такие кандидаты
Перечитывать большой файл в поисках подходящих для выноса секций утомительно и субъективно. AGENTS.md / SKILL.md Coexistence Auditor ищет разделы с признаками императивной процедуры и оценивает их объём в токенах, показывая конкретных кандидатов на вынос.
Итоговый чеклист
Императивная пошаговая структура — сильный сигнал, что секция описывает процедуру, а не общее правило, и стоит рассмотреть вынос в SKILL.md.
Общее правило нужно почти в каждой задаче, процедура — только в узком специфичном сценарии, это ключевое различие при принятии решения.
Вынесенная skill работает только с чётким, конкретным description — расплывчатая формулировка сведёт на нет весь смысл выноса.