code-review-comment-analyzer

What problem does it solve?

Code comments often become out-of-date or misleading, causing maintenance challenges and technical debt. This Skill ensures comments stay accurate, complete, and valuable over the lifecycle of a codebase.

Core Features & Use Cases

• Factual Accuracy Checks: Verify that claims in comments align with actual code behavior, signatures, and edge cases.
• Completeness Assessment: Identify missing context, preconditions, and potential side effects to prevent knowledge gaps.
• Long-term Value Evaluation: Highlight comments likely to become stale and propose updates to preserve value.
• Misleading Element Detection: Flag ambiguous or outdated wording and references to refactored code.
• Improvement Recommendations: Provide actionable rewrites and additional context suggestions for maintainers.

Quick Start

Review the repository's comments and provide a prioritized set of edits to ensure accuracy and long-term maintainability.