What problem does it solve? Code comments often drift out of sync with implementations, restate obvious code, or miss critical contract obligations. This Skill provides disciplined guidance for writing, reviewing, and migrating comments so they accurately explain behavior, caller obligations, and design rationale. ## Core Features & Use Cases - Comment Writing Guidance: Explains how to document API contracts, lifecycle obligations, local rationale, and boundary cases with concrete, maintainer-style prose. - Read-Only Comment Audits: Reports actionable missing, misleading, outdated, or redundant comments at precise locations without modifying files. - Authorized Editing and Migration: Adds, modifies, deletes, or relocates comments within authorized scope, preserving valid meaning and machine-readable directives. - Use Case: During a refactor of a Go storage interface, use this Skill to document atomicity and retry semantics so callers understand timeout behavior, then audit the surrounding package for stale comments. ## Quick Start Ask the assistant to review the comments in a specific source file and rewrite any that are outdated or misleading based on the current implementation.
