agent-md-refactor — скилл для Claude Code: что делает и как установить
Скилл реорганизует раздутые файлы CLAUDE.md или AGENTS.md. Он оставляет в корне только главное, а подробности разносит по тематическим документам.
npx claude-code-templates@latest --skill development/agent-md-refactorЧто делает agent-md-refactor
Скилл делит монолитные файлы инструкций на компактный корень и вспомогательные разделы в папке .claude/. В главный документ переносятся лишь общие команды сборки и правила, нужные для каждой задачи. Остальное группируется по темам: стек типов, тестирование, оформление кода или архитектурные соглашения.
Работа строится в пять этапов: поиск прямых конфликтов, отбор базовых инструкций, распределение правил по файлам, генерация структуры ссылок и чистка мусора. Скилл помечает на удаление фразы вроде «пишите чистый код», дублирование очевидных стандартов и устаревшие параметры.
Если в инструкциях найдутся взаимоисключающие пункты, скилл остановит работу на первой фазе и не пойдёт дальше без вашего решения.
Какие задачи решает
- разгрузить перегруженный контекст в CLAUDE.md
- найти и устранить противоречивые правила в инструкциях агента
- удалить абстрактные и очевидные требования из документации
- разнести регламенты тестирования и стиля по отдельным файлам
Примеры запросов агенту
- Реорганизуй мой CLAUDE.md по принципу progressive disclosure
- Разбей файл AGENTS.md на компактный корень и ссылки на правила
- Проверь инструкции проекта на противоречия и удали лишний текст
Как установить agent-md-refactor
1Через claude-code-templates
npx claude-code-templates@latest --skill development/agent-md-refactor2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill agent-md-refactor -a claude-code3Вручную: положить файлы
~/.claude/skills/agent-md-refactor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/agent-md-refactor/
Вручную: положить файлы
.agents/skills/agent-md-refactor/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/agent-md-refactor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates agent-md-refactor2Вручную: положить файлы
.github/skills/agent-md-refactor/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/agent-md-refactorВручную: положить файлы
.devin/skills/agent-md-refactor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о agent-md-refactor
Как установить agent-md-refactor в Claude Code?
Выполните в терминале команду npx claude-code-templates@latest --skill development/agent-md-refactor.
Что делает скилл agent-md-refactor?
Он превращает громоздкие сводки правил для агента в модульную систему: оставляет в корневом файле критически важный минимум и выносит специфичные детали в отдельные файлы с перекрёстными ссылками.
Что остаётся в корневом файле после рефакторинга?
В корне сохраняются только универсальные данные проекта: краткое описание в одну строку, пакетный менеджер, нестандартные команды запуска и правила со стопроцентным охватом.
