code-hygiene

Installation
SKILL.md

Code Hygiene

A narrow, calibrated review pass — not a general bug hunt. lint catches syntactic violations, test-coverage catches untested lines, and a normal correctness-focused review catches bugs — none of those structurally catch an abstraction that got duplicated instead of reused, a feature that validates but silently does nothing, or a comment that admits a gap nobody closed. This skill's job is specifically the class of smell that only shows up when you read code against this repo's own architectural mandates (CLAUDE.md) and ask "does this actually do what it claims to," not just "does this compile and pass its own tests."

This skill reports; it does not redesign. A real architectural smell usually needs a design decision, not a mechanical patch — report it clearly enough that a human (or a follow-up planning pass) can make that call. See "Auto-fix policy" below for the one narrow exception.

Scope: patch-aware by default

Installs
2
GitHub Stars
1.4K
First Seen
Oct 20, 2026