What problem does it solve? AI coding agents often fill code with generic, decorative comments—banner separators, step-by-step narration, restated signatures, and vague TODOs—that add noise without information. This Skill defines rules to strip that slop while protecting comments that carry real meaning. ## Core Features & Use Cases - Slop Comment Detection: Identifies decorative separators, obvious restatements, workflow narration, empty labels, vague TODOs, signature echoes, decorative emoji, and end markers. - Preservation Rules: Explicitly protects comments explaining business logic, security, performance trade-offs, API contracts, workarounds, and edge cases. - Scope Guardrail: Modifies comments only—never touches executable code, identifiers, formatting, or logic. - 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 Clean the AI-generated comments in this file, removing decorative and redundant ones while keeping any comment that explains why the code works the way it does.
