What problem does it solve? Code comments often just restate what the code already shows, adding noise instead of value. This Skill teaches you to comment WHY code exists—decisions, trade-offs, and non-obvious reasoning—instead of WHAT it does. ## Core Features & Use Cases - Intent-First Commenting: Explains the four things worth commenting: non-obvious decisions, algorithm trade-offs, magic number sources, and workarounds with issue references. - Anti-Pattern Detection: Shows concrete before/after examples of over-commenting obvious code and restating standard patterns like loops and assignments. - The Comment Test: Provides a three-question checklist to decide whether each comment should be kept, deleted, or replaced with clearer code. - Use Case: During code review, when asked to add more comments, apply this Skill to document why Redis was chosen for rate limiting and where the 100 req/min limit came from, rather than narrating each line. ## Quick Start Review the comments in my code and rewrite them to explain intent and decisions instead of restating what the code does.
