What problem does it solve? AI coding agents often leave behind generic, decorative, or redundant comments—banner separators, step-by-step narration, signature echoes—that add noise without information. This Skill gives agents concrete rules to clean up those comments while protecting the ones that carry real meaning. ## Core Features & Use Cases - Slop Comment Detection: Identifies decorative separators, restated obvious lines, workflow narration, empty labels, vague TODOs, signature echoes, decorative emoji, and end markers, each with a Tell/Why/Fix pattern. - Preservation Guardrails: Explicitly protects comments explaining business logic, security, performance trade-offs, API contracts, workarounds, and edge cases. - Scope Safety: Enforces a strict guardrail that only comments may be modified—never executable code, identifiers, formatting, or logic. - Use Case: After an AI agent generates a module full of // Step 1: Validate input and // ======= HELPERS ======= comments, run this Skill to strip the noise and keep only the comments that explain non-obvious behavior. ## Quick Start Review the comments in this file and remove any generic AI-style comments while keeping the ones that explain real business logic or constraints.
