claude-md-optimizer — плагин для Claude Code: сжимает CLAUDE.md
Скилл разбирает раздутые файлы инструкций агента на части и выносит справочники в поддокументы, чтобы контекст не тратился на то, что нужно раз в месяц.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install claude-md-optimizer@claude-communityЧто делает claude-md-optimizer
Плагин находит в репозитории три вида файлов инструкций: CLAUDE.md, AGENTS.md и .github/copilot-instructions.md. Дальше он сравнивает их размер с целевым для формата, разбирает разделы на три категории — обязательные, справочные и лишние — и показывает таблицу: что остаётся внутри, что уезжает в отдельный файл.
Работа идёт в шесть шагов, и правки начинаются только после вашего согласия с планом. Поддокументы создаются штатным механизмом формата: для CLAUDE.md это @import и .claude/rules/*.md, для AGENTS.md — вложенные файлы в подкаталогах, для Copilot — .github/instructions/NAME.instructions.md. В конце плагин сверяет содержимое до и после, чтобы ничего не потерялось.
Перед запуском он проверяет, не зашифрован ли файл через git-crypt, SOPS или age, и не сканирует ли его регуляркой какой-нибудь CI-скрипт. Если да, вынос кусков может сломать сборку — это повод сначала посмотреть на план, а не жать «выполнить». Ключевая идея плагина в том, как оформлена ссылка на вынесенный документ: короткая сводка с конкретными фактами (фреймворк, соглашение об именах, порог покрытия) отвечает агенту сразу, и открывать поддокумент он станет реже.
Какие задачи решает
- разгрузить
CLAUDE.md, разросшийся за полгода разработки - вынести справочник по API в поддокумент, оставив в основном файле сводку
- разложить правила по
.claude/rules/с привязкой к путям - уложить
AGENTS.mdв лимит цепочки вложенных файлов - проверить, что после переписывания файла ничего не потерялось
Примеры запросов агенту
- Оптимизируй
CLAUDE.md, он уже не влезает в контекст AGENTS.mdслишком длинный, разбей его на поддокументы- Примени progressive disclosure к файлам инструкций агента
Как установить claude-md-optimizer
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install claude-md-optimizer@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о claude-md-optimizer
Как установить claude-md-optimizer в Claude Code?
Через маркетплейс: сначала /plugin marketplace add anthropics/claude-plugins-community, затем /plugin install claude-md-optimizer@claude-community.
Что делает claude-md-optimizer?
Анализирует файлы инструкций агента, делит их содержимое на обязательное и справочное, выносит второе в поддокументы и переписывает основной файл со ссылками. Перед изменениями показывает план на утверждение.
Какие форматы файлов он понимает?
CLAUDE.md, AGENTS.md и .github/copilot-instructions.md. Формат определяется автоматически, для каждого используется свой механизм поддокументов.
