knip — скилл для Claude Code: поиск мёртвого кода и лишних
Скилл прогоняет knip по проекту и убирает неиспользуемые файлы, зависимости и экспорты. Пригодится, когда репозиторий оброс мусором.
npx skills add brianlovin/agent-config --skill knip -a claude-codeЧто делает knip
Скилл задаёт агенту порядок работы: сначала разобраться в проекте, потом чистить. Он смотрит package.json, ищет конфиг knip (knip.json, knip.jsonc или ключ knip в package.json) и только после этого запускает npx knip. Сначала разбираются подсказки по конфигурации в начале вывода, потому что они уменьшают число ложных срабатываний. Цикл «запустить — поправить конфиг — запустить снова» повторяется, пока подсказки не кончатся.
Дальше идут реальные находки, и тут есть приоритет: сначала неиспользуемые файлы, затем зависимости и devDependencies, потом экспорты и типы. После каждой пачки правок knip запускается заново — удаление файлов часто обнажает новые мёртвые экспорты. Для продакшена есть npx knip --production, он отсекает тесты и конфиги. Автоправки — npx knip --fix, а с удалением файлов только npx knip --fix --allow-remove-files.
Важное ограничение: knip не трогает неиспользуемые импорты и переменные внутри файлов, для этого нужен линтер вроде ESLint или Biome. Часть находок агент удаляет сам, а перед спорными спрашивает: файлы, которые могут быть точками входа или подгружаться динамически, экспорты из index.ts и lib/, зависимости, работающие через CLI или как peer. Если knip падает с кодом 2, скилл велит проверить наличие конфига и завести knip.json в корне. В монорепозиториях может понадобиться флаг --workspace.
Какие задачи решает
- найти файлы, которые никто не импортирует
- вычистить зависимости из
package.json, оставшиеся от удалённого кода - убрать экспорты и типы, потерявшие потребителей
- настроить knip под фреймворк и монорепозиторий, чтобы не ловить ложные срабатывания
- прогнать проверку только по продакшен-коду без тестов и конфигов
Примеры запросов агенту
- Прогони knip по проекту и покажи, что можно удалить
- Почисти неиспользуемые зависимости и экспорты, конфиг правь по ходу
- Запусти knip в режиме
--productionи разбери находки
Как установить knip
1Через Skills CLI (Vercel)
npx skills add brianlovin/agent-config --skill knip -a claude-code2Вручную: положить файлы
~/.claude/skills/knip/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/knip/
1Через Skills CLI (Vercel)
npx skills add brianlovin/agent-config --skill knip -a codex2Вручную: положить файлы
.agents/skills/knip/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add brianlovin/agent-config --skill knip -a cursor2Вручную: положить файлы
.cursor/skills/knip/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install brianlovin/agent-config knip2Вручную: положить файлы
.github/skills/knip/SKILL.md1Через Skills CLI (Vercel)
npx skills add brianlovin/agent-config --skill knip -a gemini-cli2Командой платформы
gemini skills install https://github.com/brianlovin/agent-config --path skills/knipВручную: положить файлы
.devin/skills/knip/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add brianlovin/agent-config --skill knip -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о knip
Как установить knip в Claude Code?
Выполните npx skills add brianlovin/agent-config --skill knip -a claude-code, скилл встанет в ~/.claude/skills/knip/SKILL.md.
Что делает скилл knip?
Запускает knip и по его отчёту убирает неиспользуемые файлы, зависимости и экспорты. Сначала агент настраивает конфиг, чтобы отчёт не был шумным.
Найдёт ли knip неиспользуемые переменные внутри файлов?
Нет. Такие находки — работа линтера, например ESLint или Biome, а knip смотрит на файлы, зависимости и экспорты по всему проекту.
