AGENTS.md / SKILL.md Coexistence Auditor
Предупредить, когда AGENTS.md разросся настолько, что часть стоит вынести в отдельные SKILL.md.
Как это работает
AGENTS.md загружается агентом при каждом обращении к проекту целиком, а SKILL.md — только когда задача реально совпала с его описанием, это и есть ключевая разница в экономике контекста между двумя форматами. Пятидесятифайловая библиотека skills не замедляет агента, а вот разросшийся до нескольких тысяч строк AGENTS.md — вполне может, потому что он грузится каждый раз без разбора, нужен ли он для конкретной задачи или нет. AGENTS.md / SKILL.md Coexistence Auditor online анализирует размер и структуру вашего AGENTS.md и предупреждает, когда часть контента логичнее вынести в отдельные skills.
Здесь работает тот же принцип progressive disclosure, что и внутри самого формата SKILL.md с его reference-файлами: общие, действительно необходимые всегда правила (стиль коммитов, базовые команды сборки) уместны в AGENTS.md, а специфичные для редких задач процедуры (как развернуть staging-окружение, как сгенерировать миграцию по шаблону) — кандидаты на отдельный SKILL.md, который подгрузится только когда реально понадобится.
Инструмент считает приблизительный объём AGENTS.md в токенах, ищет секции, которые по формулировке похожи на разовые процедуры (императивные пошаговые инструкции под конкретный редкий сценарий, а не общие принципиальные правила), и явно перечисляет их как кандидатов на вынос в отдельный SKILL.md, вместе с оценкой, сколько контекста это сэкономит при обычных задачах, не касающихся этой процедуры.
Частые вопросы
Есть ли жёсткий лимит размера AGENTS.md, после которого точно нужно разбивать?
Формальной спецификации на этот счёт нет, но практика сообщества к середине 2026 года ориентируется на компактность — файл должен помещаться в разумный объём, который агент прочитает при каждом обращении без ощутимой траты контекста впустую.
Как отличить общее правило, которое стоит держать в AGENTS.md, от процедуры-кандидата на SKILL.md?
Общее правило применимо почти к любой задаче в проекте (стиль кода, команды тестов), а процедура-кандидат на SKILL.md обычно императивна и привязана к конкретному узкому сценарию, который возникает не в каждой задаче, а лишь изредка, при конкретном типе работы.
Что если вынести процедуру в SKILL.md, а агент не понимает, когда её вызывать?
Это указывает на слишком расплывчатое description у skill — оно должно явно и конкретно описывать сценарий применения, чтобы агент мог сопоставить его с реальной задачей уже на этапе первичного сканирования кратких описаний всех skills.
Работает ли этот же принцип разделения для CLAUDE.md?
Да, у CLAUDE.md собственная более богатая трёхуровневая модель памяти, но базовый принцип экономии контекста через вынос редко нужного контента в отдельные skills применим точно так же, вне зависимости от того, AGENTS.md это или CLAUDE.md на верхнем уровне.