What problem does it solve? Code comments drift out of sync with the code they describe as refactors rename parameters, change signatures, and reorganize APIs. This Skill detects those contradictions without auto-fixing them, since every mismatch is a judgment call between updating the comment or fixing the code. ## Core Features & Use Cases - Multi-language comment verification: Checks Python docstrings against function signatures, Go godoc against exported APIs, Helm values.yaml comments against template usage, Dockerfile comments against instruction layers, shell-script header comments against function bodies, and GitHub Actions workflow comments against step definitions. - Read-only findings log: Appends every mismatch to a dated memory file with status markers ([pending], [flagged], [fixed]) so a human reviewer or backlog counter can triage later. - False-positive guards: Skips missing annotations, stylistic deviations, generated/vendored code, and known-external value patterns to avoid noise. - Use Case: After a refactor that renamed function parameters across a Python and Go codebase, run this Skill to list every docstring and godoc comment that still references the old names, then let a human decide whether to update the docs or revert the code. ## Quick Start Ask the agent to verify code comments against reality across the repository and log any mismatches it finds.
