review-comments

Review and clean up low-quality code comments across staged, changed, or all files.

1|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/nielsmadan/agentic-coding --skill review-comments-nielsmadan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-comments
Source: https://github.com/nielsmadan/agentic-coding/tree/main/claude/skills/review-comments
Command: npx skills add https://github.com/nielsmadan/agentic-coding --skill review-comments-nielsmadan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the issue of low-quality, redundant, or unhelpful code comments, improving code readability and maintainability.

Core Features & Use Cases

  • Comment Quality Assessment: Identifies comments that explain "what" the code does instead of "why".
  • Comment Noise Reduction: Helps clean up comments that add little to no value.
  • Automated Fixing: Offers options to automatically remove or refactor problematic comments.
  • Use Case: Before submitting a pull request, run this Skill to ensure all comments are concise, informative, and truly necessary, making the codebase easier for others to understand.

Quick Start

Run the review-comments skill to analyze staged and changed files for low-quality comments.

Frequently Asked Questions about review-comments

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up low-quality code comments before a pull request?

To clean up low-quality code comments, you can run a review process that identifies redundant comments, reduces noise, and transforms "what" comments into "why" comments for better readability.

What is the difference between what and why comments in code review?

In code review, "what" comments describe obvious code mechanics and add noise, whereas "why" comments explain intent and design decisions, making the codebase easier to understand and maintain.

Can I automatically fix and refactor problematic comments in staged files?

Yes, you can automatically fix problematic comments in staged and changed files by utilizing parallel agent processing and Git commands to remove or refactor unhelpful noise automatically.

Does this code review tool support analyzing the entire codebase or just changed files?

This code review tool supports analyzing various scopes including staged files, recently changed files, and all files within the codebase to identify and clean up low-quality comments.

What is the best way to reduce comment noise in a git repository?

The best way to reduce comment noise in a git repository is to assess comment quality across staged or all files, automatically removing redundant statements and refactoring explanations to focus on intent.