Clean Comments

Audit and repair EXISTING code comments so each says what the code cannot (intent, rationale, invariants, units, gotchas) and none restates it: delete restatement, banners and commented-out code, fix stale or wrong comments, sharpen bloated ones. Use whenever the user asks to clean up, audit, review or fix comments, remove redundant or obvious comments, tidy doc comments or docstrings, strip commented-out code, "make comments follow Ousterhout", or improve comment quality across a file, a directory, or a changeset (staged diff, commit range, PR), even if they only say "the comments need work". Do NOT use for comments on code you are writing right now (use `write-comments`).

spencermarx Updated

File contents

spencermarx/skills commit 67018cb614 Runs: spencermarx/setup-aclarify-skills

Frequently asked questions

npx get-skill add spencermarx/clean-comments