What problem does it solve? Codebases accumulate casual, outdated, redundant, or missing comments that hurt readability during code review, handoff, or open-sourcing. This Skill professionalizes comments and performs safe cleanup while guaranteeing that program logic and behavior remain untouched. ## Core Features & Use Cases - Comment Audit and Rewrite: Classifies every comment (junk, placeholder, outdated, redundant, informal-but-valuable, missing) and rewrites, removes, or adds comments using idiomatic doc formats like JSDoc, docstrings, or XML doc comments. - Non-Semantic Cleanup: Normalizes whitespace, indentation, and brace style, removes unambiguous dead code, and splits long lines without changing behavior. - Verification and Reporting: Re-reads the full diff to confirm behavioral identity and reports exactly what was rewritten, removed, or flagged as uncertain. - Use Case: Before open-sourcing a module full of comments like "// idk why but it works", run this Skill to produce professional documentation while preserving every real warning embedded in the original notes. ## Quick Start Clean up and professionalize all comments in this file without changing any logic or behavior.
