audit-comments
Use when auditing comments, docstrings, or embedded documentation prose in a scope — to strip bloat and rewrite cluttered-but-justified entries. Triggers on "audit comments", "clean up docstrings", "strip stale comments", "comment cleanup".
What it does
target = $ARGUMENTS
If target provided, audit that path. Otherwise, files changed since the default branch. Full-codebase audit requires explicit user request.
Strip comments that don't earn their place; rewrite those that do but bury the signal.
Type annotations are primary documentation; every comment competes against the signature, body, and adjacent declarations. A comment survives only by carrying a WHY sourced from outside the codebase — a cited bug, a spec, a third-party quirk, a business rule, a historical decision. Behavioral narration ("idempotent", "no-op when empty", "callers rely on X") fails the test no matter how accurate — the code is the source; strip it. Named symbols must resolve. A missing comment beats a wrong one — when torn, strip. Skip user-facing strings, log templates, and generated code.
Capabilities
Install
Quality
deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (828 chars)