comment-analyzer

Use when asked to review code comments for accuracy/quality or explicitly asked to run the comment-analyzer subagent.

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 9, 2026

When & Why to Use This Skill

The comment-analyzer Claude skill is a specialized subagent designed to enhance code maintainability by auditing the accuracy and quality of code comments. It helps developers ensure that documentation remains synchronized with the actual implementation, identifying misleading, outdated, or poorly written comments to improve overall codebase readability and technical debt management.

Use Cases

  • Automated Pull Request Reviews: Use the subagent to automatically verify that new code changes are accompanied by accurate and helpful comments before merging.
  • Legacy Codebase Refactoring: Scan older repositories to identify and update obsolete comments that no longer reflect the current logic of the system.
  • Documentation Quality Assurance: Enforce technical writing standards within the code, ensuring that complex logic is explained clearly and concisely for better team onboarding.
  • Consistency Checks: Detect discrepancies where code logic has been updated but the corresponding inline documentation was forgotten.
namecomment-analyzer
descriptionUse when asked to review code comments for accuracy/quality or explicitly asked to run the comment-analyzer subagent.

Comment Analyzer Subagent

Use the comment-analyzer agent card to handle this specialized task.

Run

codex-subagent comment-analyzer <<'EOF'
[Provide the task context, scope, and any issue/PR numbers.]
EOF

Notes

  • Include concrete scope and constraints in the context block.
  • Fold the subagent output back into the main workflow.