ai-slop-cleaner

Apply a regression-tests-first workflow to clean AI-generated code within a changed-files scope.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/pextacy/stellar --skill ai-slop-cleaner-pextacy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-slop-cleaner
Source: https://github.com/pextacy/stellar/tree/main/skills/ai-slop-cleaner
Command: npx skills add https://github.com/pextacy/stellar --skill ai-slop-cleaner-pextacy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reduce AI-generated slop by enforcing a regression-tests-first cleanup workflow that preserves behavior and raises signal quality.

Core Features & Use Cases

  • Regression-tests-first cleanup approach bound to a changed-files scope or Ralph workflow to limit edits
  • Clear categorization of smells (Duplication, Dead code, Needless abstraction, Boundary violations) and execution of passes one smell at a time
  • Evidence-dense reporting that documents changes, tests, and remaining risks

Quick Start

Provide an initial cleanup plan and start the first pass on the targeted files.

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 breaking existing behavior?

AI code cleanup requires a regression-tests-first workflow to preserve behavior while reducing slop. You provide a cleanup plan and changed-files list, then execute staged passes for specific smells before running regression tests and lint checks.

What is a regression-tests-first workflow for AI code cleanup?

A regression-tests-first workflow means establishing tests that lock current behavior before removing AI code smells. This ensures that staged refactoring passes for duplication, dead code, or needless abstraction do not introduce functional regressions.

How do I remove code smells from AI-generated edits in a specific scope?

You remove code smells from AI edits by bounding the cleanup to a changed-files list or Ralph workflow to limit scope. This allows targeted passes for duplication, dead code, needless abstraction, and boundary violations one smell at a time.

Does AI slop cleanup require a defined plan before starting?

Yes, AI slop cleanup requires a defined plan before starting. You must provide an initial cleanup plan to bound the scope, then start the first pass on targeted files to execute smell removal, regression tests, and lint checks systematically.

What categories of code smells are targeted during AI code refactoring?

Code smells targeted during AI refactoring include Duplication, Dead code, Needless abstraction, and Boundary violations. The workflow executes staged passes to resolve these issues one smell category at a time, maintaining structured and disciplined cleanup.

How do I document changes and remaining risks after refactoring AI code?

You document changes and remaining risks after refactoring AI code by generating an evidence-dense report. This report records applied changes, executed regression tests, and remaining risks discovered during the staged smell removal passes.