zero-tech-debt — скилл для Claude Code: рефакторинг без легаси-хвостов
Разворачивает патч от нужного конечного состояния, а не от истории правок: удаляет мёртвые ветки совместимости и лишнюю сложность.
npx skills add jnsahaj/skills --skill zero-tech-debt -a claude-codeЧто делает zero-tech-debt
Скилл просит агента сначала сформулировать, каким должен быть результат в одной-двух фразах. Дальше он ищет реальных вызывающих. Если у режима, пропа, обёртки, алиаса маршрута или запасного варианта нет ни одного текущего вызова, они удаляются.
Перестройка идёт вокруг итоговой поверхности продукта: один понятный компонент или поток вместо набора флагов. Делить советуется только там, где граница очевидна — состояние, разметка, элементы управления, доменные команды. Общие правила вроде флагов, прав доступа, гейтинга маршрутов, состояния в URL и имён команд скилл требует держать в одном месте, а не дублировать по страницам.
Финальный шаг — проверка нового потока и удалённых допущений, которые влияли на навигацию, права или сохранённое состояние. Ограничение важное: скилл велит оптимизировать код под то, что должно остаться, а не под минимальный дифф, но запрещает изобретать общий фреймворк ради одной функции и расширять рефакторинг за пределы связности итоговой формы.
Какие задачи решает
- удалить мёртвые ветки совместимости из патча
- свести набор режимов и флагов к одному потоку
- вынести дублирующиеся проверки прав в одно место
- переименовать сущности под смысл продукта, а не под историю правок
- проверить, что удалённые допущения не сломали навигацию
Примеры запросов агенту
- Сформулируй конечное состояние этого изменения и убери всё, что существует только ради совместимости.
- Пройди по патчу и удали режимы, флаги и обёртки, у которых нет текущих вызывающих.
- Сведи флаги и проверки прав из разных страниц в одно место, потом проверь поток.
Как установить zero-tech-debt
1Через Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill zero-tech-debt -a claude-code2Вручную: положить файлы
~/.claude/skills/zero-tech-debt/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/zero-tech-debt/
1Через Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill zero-tech-debt -a codex2Вручную: положить файлы
.agents/skills/zero-tech-debt/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill zero-tech-debt -a cursor2Вручную: положить файлы
.cursor/skills/zero-tech-debt/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jnsahaj/skills zero-tech-debt2Вручную: положить файлы
.github/skills/zero-tech-debt/SKILL.md1Через Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill zero-tech-debt -a gemini-cli2Командой платформы
gemini skills install https://github.com/jnsahaj/skills --path skills/zero-tech-debtВручную: положить файлы
.devin/skills/zero-tech-debt/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jnsahaj/skills --skill zero-tech-debt -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о zero-tech-debt
Как установить zero-tech-debt в Claude Code?
Выполните npx skills add jnsahaj/skills --skill zero-tech-debt -a claude-code. Скилл окажется в ~/.claude/skills/zero-tech-debt/SKILL.md.
Что делает zero-tech-debt?
Заставляет агента переделывать изменение от задуманного конечного состояния: сначала цель, потом поиск реальных вызовов, затем удаление неиспользуемых путей и сведение общих правил в одно место.
Скилл перепишет весь проект?
Нет, рефакторинг ограничен тем, что делает итоговую форму связной. Общий фреймворк под одну функцию он создавать запрещает.
