What problem does it solve? AI coding agents tend to leave behind generic, decorative comments — banner separators, step-by-step narration, restated signatures, vague TODOs — that add noise instead of information. This Skill gives agents concrete rules to strip that slop while protecting comments that carry real meaning, and it never modifies the code itself. ## Core Features & Use Cases - Slop Pattern Detection: Identifies decorative separators, obvious restatements, workflow narration, empty labels, vague TODOs, signature echoes, decorative emoji, and end markers, each with a Tell / Why / Fix structure. - Preservation Rules: Explicitly protects comments explaining business logic, security, performance trade-offs, concurrency, API contracts, workarounds, and edge cases. - Scope Guardrail: Restricts edits strictly to comments — executable code, identifiers, imports, formatting, and logic are never touched. - Use Case: After an AI agent generates a module full of // Step 1: Validate input and // ======= ROUTES ======= comments, run this Skill to clean the file down to only the comments that explain non-obvious behavior. ## Quick Start Review the comments in this file, remove the ones that restate the obvious or decorate sections, and keep only comments that explain why the code behaves the way it does.
