What kind of 'noise' comments does it flag?

It flags obvious comments (e.g., '// Get the user' for $this->getUser()), file headers, section dividers, and closing brace comments.

Does this skill support languages other than PHP?

This specific skill is tailored for PHP standards and PHPDoc conventions as part of the PHP Architecture Toolkit.

Can Claude automatically fix the comment issues it finds?

Yes, Claude can use this skill to identify issues and then generate the corrected PHPDoc or refactor the code to be self-documenting.

How does it detect outdated comments?

It analyzes the function logic, parameters, and return types, then compares them against the text in the comment block to find contradictions.

PHP Comment Quality Checker

Name: PHP Comment Quality Checker
Author: dykyi-roman

bydykyi-roman

•

学習とドキュメンテーション

Audits PHP codebases to identify missing PHPDoc, outdated documentation, and dead code patterns to improve maintainability.

The Check Comments skill is a specialized tool designed for PHP developers using Claude Code to maintain high documentation standards and clean code architecture. It automatically scans your repository for common pitfalls such as missing public API documentation, misleading or outdated comments that no longer match the implementation, and cluttered commented-out code blocks. By suggesting self-documenting code alternatives and enforcing PHPDoc best practices, it helps teams reduce technical debt and ensure that the codebase remains readable, professional, and easy to navigate for new contributors.

主な機能

0145 GitHub stars

02Locates and flags 'dead' commented-out code blocks that should be removed

03Suggests self-documenting code refactors to replace redundant or obvious comments

04Detects missing PHPDoc for public methods, classes, and properties

05Validates @throws documentation and complex type annotations

06Identifies outdated or misleading comments that contradict current logic

ユースケース

01Improving IDE autocompletion by ensuring correct type hints and PHPDoc structures

02Cleaning up legacy PHP projects by removing noise comments and section dividers

03Conducting documentation audits during the code review process to ensure API clarity

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code check-comments

For use in Claude.ai and ChatGPT

Download Skill