cleanup-slop
Installation
SKILL.md
Surgically remove unhelpful comments without touching code. The good comments — workarounds, invariants, citations, non-obvious WHYs — stay. The bad ones — restating code, narrating in-motion edits, AI-generated platitudes — go.
Core rule: a useful comment tells a future reader something they couldn't get by reading the code itself. Everything else is noise.
Preflight
- Language detect — comment syntax differs but the patterns are universal.
- Git state: refuse on dirty tree.
- Report dir: ensure exists.
- No code changes: this skill ONLY edits comments. If a "comment fix" requires changing code, surface to user instead.
Detect
Use grep + heuristics. There's no perfect tool — this is mostly pattern matching.