About ai-slop-cleaner
AI Slop Cleaner is a coding skill for removing bloat and duplication from working code while preserving behavior. It suits focused cleanup, with tests used to check regressions after changes.
Key features
- 01Deletion-first code cleanup
- 02Duplicate and dead code removal
- 03Scope-bounded changes
- 04Tests before and after edits
- 05Reviewer-only findings mode
Use cases
- 01Remove unused code from a working project
- 02Simplify repeated or over-abstracted logic
- 03Review cleanup candidates without editing
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/ai-slop-cleanerin Claude Code to confirm it loaded.
Details
From the project READMEAI Slop Cleaner
Clean AI-generated code slop without changing behavior. Deletion-first workflow with regression safety.
When to Use
- Code that works but feels bloated, repetitive, or over-abstracted
- Duplicate logic, dead code, wrapper layers, boundary leaks
--reviewfor reviewer-only mode (no changes, just findings)
When NOT to Use
- New feature build or product change
- Broad redesign
- Behavior is unclear and untestable
Principles
- Preserve behavior unless explicitly asked for changes
- Delete before refactoring — removal is safest
- Scope-bounded: only clean what was specified
- Regression-safe: verify tests pass after every change
Slop Signals
- Unnecessary wrapper functions
- Duplicated logic across files
- Over-abstracted single-use helpers
- Dead code / unreachable branches
- Excessive comments restating obvious code
- Premature abstractions (used only once)
Workflow
- Identify target files/scope
- Run existing tests (baseline)
- Apply deletions first (dead code, unused imports)
- Simplify remaining code (reduce nesting, merge duplicates)
- Re-run tests after each change
- Report what was cleaned and verification results
Comments
Markdown supported