How does this skill improve code quality?

It enforces strict guidelines that reduce noise, ensuring comments are meaningful and the codebase remains free of dead, commented-out code.

Can I use end-of-line comments with this skill active?

The skill guidelines specifically advise against end-of-line comments, recommending that documentation be placed directly above the code it describes for better readability.

Does it automatically delete code?

It provides specific instructions for Claude to follow, directing the AI to remove commented-out code instead of leaving it in the file as technical debt.

Why does it discourage using past tense in comments?

Comments should describe the current state and intent of the code. Using past tense often describes the process of changing the code, which is better handled by git commit messages.

Clean Code Comments

Name: Clean Code Comments
Author: motlin

bymotlin

0•

开发者工具

Enforces professional documentation standards by streamlining source code comments and removing redundant historical data.

The Clean Code Comments skill provides a robust framework for managing internal documentation within your codebase. It ensures that comments are purposeful, concise, and focused on explaining current logic rather than documenting the history of changes. By discouraging commented-out code, end-of-line placement, and process-oriented descriptions, this skill helps developers maintain a high standard of readability and reduces the cognitive load required to understand complex logic during code reviews and maintenance.

主要功能

01Enforces the removal of commented-out code to reduce technical debt

02Discourages process-oriented comments that use past tense verbs

03Promotes sparse, high-impact documentation over noisy commentary

04Filters out redundant versioning information within source files

050 GitHub stars

06Standardizes comment placement above the relevant code blocks

使用场景

01Establishing consistent documentation standards across a shared team codebase

02Cleaning up AI-generated code to ensure it meets professional style guidelines

03Refactoring legacy repositories to improve long-term maintainability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add motlin/claude-code-plugins comment-cleanup

For use in Claude.ai and ChatGPT

Download Skill