# codehygiene

Скилл codehygiene для Claude Code проверяет читаемость кода после его написания, правки, рефакторинга или ревью. Находит сложную вложенность, неясные имена и другие проблемы, которые пропускают форматтеры.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 287 у репозитория
- Автор: brianbell-x
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/brianbell-x/codehygiene/tree/HEAD/codehygiene/SKILL.md
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/codehygiene

## Что делает

codehygiene запускает проверку читаемости изменённых файлов на Python, TypeScript, JavaScript, Rust, Go, C, C++, Zig, Java, C# и Lua. Она находит глубоко вложенный код, лишние комментарии, проглоченные ошибки, неясные имена переменных, магические индексы и дублирующиеся блоки. Проверку нужно запускать после каждого изменения кода.

Для запуска нужны Python и файлы скилла, включая `weights.npz`; скрипт работает офлайн. Если в окружении нет `numpy`, запускайте его через `uv run --with numpy`. Команда для проверки: `python3 "<SKILL_DIR>" <touched-files> --check`. После исправлений проверку запускают снова; она должна завершиться с кодом `0`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brianbell-x/codehygiene --skill codehygiene -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/codehygiene/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/codehygiene/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brianbell-x/codehygiene --skill codehygiene -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/codehygiene/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brianbell-x/codehygiene --skill codehygiene -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/codehygiene/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install brianbell-x/codehygiene codehygiene
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/codehygiene/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add brianbell-x/codehygiene --skill codehygiene -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/brianbell-x/codehygiene --path codehygiene
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/codehygiene/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/brianbell-x/codehygiene/tree/HEAD/codehygiene/SKILL.md

## Когда брать
- найти проглоченные ошибки и небезопасные заглушки
- упростить глубоко вложенный код
- заменить неясные имена и магические индексы
- убрать комментарии-пересказы и дублированные блоки

## Примеры запросов агенту
- Проверь читаемость изменённых файлов и исправь все замечания.
- Проведи ревью кода в `src/parser.py` на проблемы читаемости.
- После рефакторинга проверь изменённые файлы с помощью codehygiene.

## Похожие
- [finding-duplicate-functions](https://affpapa.org/nevibecode/skills/finding-duplicate-functions.md) — скилл · 659 установок
- [coding-standards](https://affpapa.org/nevibecode/skills/coding-standards.md) — скилл · 7900 установок
- [dry-refactoring](https://affpapa.org/nevibecode/skills/dry-refactoring.md) — скилл · 4100 установок
- [tech-debt-analyzer](https://affpapa.org/nevibecode/skills/tech-debt-analyzer.md) — скилл · 991 установка
- [command-pattern](https://affpapa.org/nevibecode/skills/command-pattern.md) — скилл · 668 установок
- [jscodeshift](https://affpapa.org/nevibecode/skills/jscodeshift.md) — скилл · 422 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
