clean-code-ch04-comments
CommunityImprove code clarity by auditing comments
Software Engineering#linting#documentation#refactoring#static-analysis#coding-standards#code-review#comment-quality
Authorhatlesswizard
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Comments are often the source of confusion and maintenance cost when they clutter code, mislead readers, or repeat what the code already expresses. This skill helps enforce clean-code comment practices by detecting redundant, misleading, mandated, journal, noise, and commented-out code, and by validating good comment patterns.
Core Features & Use Cases
- Detect and classify problematic comment patterns including mumbling, redundancy, misdirection, mandated boilerplate, journal-style notes, noisy commentary, and commented-out code.
- Recommend concrete improvements and align comments with actual intent, supporting refactors and PR reviews.
- Integrate into code review workflows and CI checks to surface violations early during development and onboarding.
Quick Start
Run the skill against your repository to surface comment quality violations and receive recommended cleanup actions.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: clean-code-ch04-comments Download link: https://github.com/hatlesswizard/clean-code-skills/archive/main.zip#clean-code-ch04-comments Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.