Skip to content

AI Slop Cleaner

Trim bloated, repetitive AI-generated code without changing its behavior

Stars
40,512
Licence
MIT
Files
1 file

What it does

This skill teaches the agent a disciplined way to clean up code that an AI wrote and that works but feels bloated: duplicate logic, dead code, pass-through wrappers, and weak tests. The agent first locks in current behavior with regression tests, writes a cleanup plan, then removes code in small, reversible steps, deleting before adding. It can also run a separate reviewer-only pass (--review) that checks cleanup work without editing files.

Great for

  • Developers who have accepted AI-generated code that runs but is messy or over-engineered
  • Teams doing a bounded cleanup after a feature or agent session, limited to the changed files
  • Reviewers who want a second-pass checklist for leftover dead code, duplication, and missing tests

Skip it if

  • New feature work or product changes, which the skill itself says it should not be used for (scope drift)
  • Broad redesigns or generic refactors, since the workflow is designed for incremental cleanup only
  • Code whose behavior is unclear and cannot be protected by tests, because the skill requires a verification plan before editing

Try asking

  • “Clean up the AI-generated code in src/auth/ without changing behavior: remove duplicate helpers and dead code”
  • “Run an anti-slop review of the files changed in this session using --review and give me a verdict”
  • “Deslop skills/ralph/SKILL.md and skills/ai-slop-cleaner/SKILL.md, keeping the diff small”
  • “Find needless wrapper layers in the payments module and propose consolidation with tests first”
Step-by-step guide: how to use AI Slop CleanerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    ai-slop-cleaner.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip ai-slop-cleaner.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip ai-slop-cleaner.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give an explicit file list or changed-file scope so the cleanup stays bounded
  • Make sure the project has runnable tests first; the skill relies on regression tests to prove behavior is preserved
  • Use --review as a separate pass after cleanup, rather than letting the same session approve its own edits

What's inside

  • SKILL.md

Redistributed unmodified from Yeachan-Heo/oh-my-claudecode under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.