What problem does it solve?
Codebases accumulate low-value comments that restate the code, record change history, or contain stale measurements, which mislead readers and add maintenance noise. This Skill gates every comment before it is written or edited so only comments that explain a non-obvious why survive.
Core Features & Use Cases
- Comment gating: Applies a single test—what does this tell a reader that the code cannot—and deletes narration, change-history notes, perishable measurements, commented-out code, and redundant docstrings.
- Keep criteria: Preserves comments that explain a non-obvious why, warn about non-local consequences, or point to external context like specs and tickets.
- Style rules: Enforces explicit technical writing, ASD-STE100 Simplified Technical English, no em-dashes, and density matching the surrounding file.
- Use Case: While reviewing a diff that adds
# increment the counter above counter += 1 and # per PR #1234, the Skill flags both for deletion and suggests a better variable name instead.
Quick Start
Review the comments in my pull request diff and remove or rewrite any that restate the code instead of explaining why.
