Comment Analyzer

Analyzes code comments for accuracy, completeness, and long-term maintainability. Detects comment rot and misleading documentation. Use after adding or modifying code comments.

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add euxx/claude-skills-for-copilot --skill comment-analyzer
Manual install
git clone --depth 1 https://github.com/euxx/claude-skills-for-copilot.git /tmp/claude-skills-for-copilot
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills-for-copilot/skills/comment-analyzer ~/.claude/skills/comment-analyzer

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Comment Analyzer

Analyze code comments for accuracy, completeness, and long-term maintainability. Protect codebases from comment rot by ensuring every comment adds genuine value.

## When to Use

- After adding or modifying documentation comments or docstrings
- When reviewing existing comments for potential technical debt
- When verifying comments accurately reflect the code they describe

## Analysis Steps

1. **Verify Factual Accuracy**: Cross-reference every claim against the actual code.
   - Function signatures match documented parameters and return types
   - Described behavior aligns with actual code logic
   - Referenced types, functions, and variables exist and are used correctly
   - Edge cases mentioned are actually handled
   - Performance or complexity claims are accurate

2. **Assess Completeness**:
   - Critical assumptions or preconditions are documented
   - Non-obvious side effects are mentioned
   - Complex algorithms have their approach explained
   - Business logic rationale is captured when not self-evident

3. **Evaluate Long-term Value**:
   - Comments that merely restate obvious code should be flagged for removal
   - Comments explaining _why_ are more valuable than those explaining _what_
   - Comments that will become outdated with likely future changes should be reconsidered
   - Avoid comments referencing temporary states or transitional implementations

4. **Identify Misleading Elements**:
Read the full skill on GitHub

Details

Skill name
comment-analyzer
Path
skills/comment-analyzer/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Comment Analyzer skill do?

Analyzes code comments for accuracy, completeness, and long-term maintainability. Detects comment rot and misleading documentation. Use after adding or modifying code comments.

How do I install the Comment Analyzer skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add euxx/claude-skills-for-copilot --skill comment-analyzer. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Comment Analyzer popular?

It lives in euxx/claude-skills-for-copilot, which has 5 GitHub stars and 0 forks.

Related skills

Code Review

5

euxx/claude-skills-for-copilot

Multi-agent code review for local changes, files, or directories. Detects bugs, security issues, and conventions-file violations (AGENTS.md/CLAUDE.md/GEMINI.md).

Git & Code Review

Code Simplifier

5

euxx/claude-skills-for-copilot

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Works on recently modified code, a set of changes, or the whole codebase.

Software Development

Conventions Improver

5

euxx/claude-skills-for-copilot

Audit and improve project conventions files (AGENTS.md, CLAUDE.md, GEMINI.md). Scans for all conventions files, evaluates quality against a scoring rubric, outputs a quality report, then makes targeted improvements with user approval. Use when asked to check, audit, update, or improve AGENTS.md or similar files.

AI, LLMs & Agents

Constraint Driven Development

9

sandbaseai/workbuddy-skill

Use when a project needs a written, measurable quality bar that agents and CI can enforce without quietly weakening tests, security, performance, accessibility, or architecture checks.

Software Development

Coding

5

roby2358/skills

Project-specific coding conventions and constraints. Use when writing, modifying, or refactoring any code, implementing features, writing tests, or building MCP servers in this project.

Software Development

Data Quality Frameworks

9

sandbaseai/workbuddy-skill

Use when implementing data-quality checks, data contracts, validation pipelines, freshness monitoring, or CI/CD gates for analytical and operational datasets.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.