ai-slop-cleaner

Automate a regression-tests-first, smell-by-smell AI code cleanup workflow.

2|1|Updated Oct 8, 2009
One-click install
npx skills add https://github.com/riethmayer/dotfiles --skill ai-slop-cleaner-riethmayer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-slop-cleaner
Source: https://github.com/riethmayer/dotfiles/tree/main/stow/agents/.agents/skills/ai-slop-cleaner
Command: npx skills add https://github.com/riethmayer/dotfiles --skill ai-slop-cleaner-riethmayer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reduce AI-generated slop with a disciplined, regression-tests-first cleanup workflow that preserves behavior while improving signal quality.

Core Features & Use Cases

  • Bounded scope: operates on a specified set of files or changed files to minimize risk.
  • Structured passes: executes passes one smell at a time with explicit planning and traceability.
  • Evidence-rich reporting: finishes with an evidence-dense report highlighting changes and remaining risks.

Quick Start

Provide a clear, bounded target (files or scope) and invoke the ai-slop-cleaner workflow to start.

Frequently Asked Questions about ai-slop-cleaner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up AI generated code without changing its behavior?

AI code cleanup that preserves behavior requires a regression-tests-first workflow. This Skill automates smell-by-smell refactoring within a bounded scope, using staged passes and quality gates to ensure functionality remains intact.

What is the best way to refactor dead code and duplication in changed files?

Refactoring dead code and duplication in changed files is best handled by a structured cleanup workflow. This Skill executes targeted passes one smell at a time, providing an explicit plan and an evidence-dense report to verify correctness.

How do I use regression tests to verify AI code refactoring?

Regression tests verify AI code refactoring by validating behavior before and after changes. This Skill mandates a regression-tests-first approach, applying quality gates at each stage to prevent functionality regressions during cleanup.

Does AI slop cleanup work on a specific set of files or changed files?

AI slop cleanup operates on a bounded scope, targeting either a specific set of files or changed files. This minimizes risk by ensuring the cleanup workflow only refactors the explicitly defined target area.

What are the limitations of automated code quality refactoring for boundary violations?

Automated code quality refactoring for boundary violations is limited by scope and traceability. This Skill mitigates limitations by providing an explicit cleanup plan and an evidence-dense report to highlight remaining risks after the passes.

Why does AI generated code need a smell-by-smell cleanup workflow?

AI generated code needs a smell-by-smell cleanup workflow to systematically reduce slop while preserving behavior. Structured passes handle code smells like duplication and dead code incrementally, ensuring traceable and safe improvements.