comment-review

Review code comments for rationale and noise against best practices.

Updated Aug 23, 2026

Search Tags:#documentation #readability #code-quality #best-practices #code-review #comment-review

One-click install

npx skills add https://github.com/lattenwald/my-home-manager --skill comment-review

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: comment-review
Source: https://github.com/lattenwald/my-home-manager/tree/main/claude/skills/comment-review
Command: npx skills add https://github.com/lattenwald/my-home-manager --skill comment-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates code comments against best practices, ensuring comments add value by explaining rationale rather than restating obvious code.

Core Features & Use Cases

Good Comments (WHY): Identifies comments that explain decisions, constraints, and context instead of restating code.
Noise Removal: Flags comments that merely restate obvious actions and should be removed.
Public API Rationale: Suggests documenting API behavior and expectations with reasoning.
Output & Guidance: Provides actionable recommendations and concrete examples to improve comment quality.

Quick Start

Ask Claude to review the comments in a code file (e.g., main.go) and evaluate whether each comment explains WHY, cites context, and avoids repetition. Request a prioritized report with suggested rewrites.