clean-code · davila7 — скилл для Claude Code: стандарты кода без лишнего
Задаёт агенту правила чистого кода: короткие функции, понятные имена, никаких очевидных комментариев и лишних абстракций. Пригодится, когда агент пишет рабочий код, а не учебник.
npx claude-code-templates@latest --skill development/clean-codeЧто делает clean-code
Скилл описывает набор правил, по которым агент пишет и правит код. Внутри — таблицы с принципами (единая ответственность, DRY, KISS, YAGNI), соглашения об именах, ограничения на размер функций и структуру вложенности. Отдельный блок про анти-паттерны: комментарий к каждой строке, хелпер для однострочника, фабрика ради двух объектов, utils.ts с одной функцией.
Перед правкой любого файла скилл требует проверить, кто этот файл импортирует и какие тесты его покрывают, а изменения в зависимых файлах делать в той же задаче. После работы — самопроверка: цель достигнута, все нужные файлы изменены, линтер и TypeScript проходят. Если что-то не сходится, агент обязан починить это до отчёта о завершении.
В скилле есть раздел про запуск проверочных скриптов, но он рассчитан на другие скиллы из того же набора: каждый агент запускает только свои скрипты, например ux_audit.py для фронтенда или api_validator.py для бэкенда. Если этих скиллов у вас нет, скрипты просто не найдутся — сам clean-code работает без них. Разрешения ограничены инструментами Read, Write и Edit.
Какие задачи решает
- заставить агента писать короткие функции вместо простыней на сотни строк
- убрать очевидные комментарии, которые агент добавляет к каждой строке
- переименовать переменные вида
nиdataв говорящие имена - проверить перед правкой файла, кто его импортирует и что сломается
- вычистить лишние абстракции вроде фабрики ради двух объектов
Примеры запросов агенту
- добавь эндпоинт для смены пароля, следуй clean-code
- почини баг с дублированием email, объяснений не надо
- отрефактори
UserService.tsпо правилам clean-code и проверь зависимые файлы
Как установить clean-code
1Через claude-code-templates
npx claude-code-templates@latest --skill development/clean-code2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill clean-code -a claude-code3Вручную: положить файлы
~/.claude/skills/clean-code/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/clean-code/
Вручную: положить файлы
.agents/skills/clean-code/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/clean-code/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates clean-code2Вручную: положить файлы
.github/skills/clean-code/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/clean-codeВручную: положить файлы
.devin/skills/clean-code/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора205
Весь набор →Другие версии clean-code
Похожие
Рядом в теме «Код-ревью и рефакторинг»
Всё по теме «Код-ревью и рефакторинг» →Вопросы о clean-code
Как установить clean-code в Claude?
Через шаблоны: npx claude-code-templates@latest --skill development/clean-code. Второй способ — npx skills add davila7/claude-code-templates --skill clean-code -a claude-code. После установки файл лежит в ~/.claude/skills/clean-code/SKILL.md.
Что делает скилл clean-code?
Задаёт агенту правила написания кода: одна ответственность на функцию, понятные имена, ранние возвраты вместо глубокой вложенности, никаких очевидных комментариев. Плюс самопроверка перед тем, как агент скажет, что задача готова.
Нужны ли Python и другие скиллы для работы clean-code?
Сам скилл работает без них. Проверочные скрипты вроде ux_audit.py и api_validator.py относятся к другим скиллам набора, и запускать их должен соответствующий агент.
