comment-analyzer
Use when asked to review code comments for accuracy/quality or explicitly asked to run the comment-analyzer subagent.
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.
| name | comment-analyzer |
|---|---|
| description | Use 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.