← ClaudeAtlas

comment-hygienelisted

Stop the agent narrating code with redundant comments, and clean up code that is already full of them. Use when the user says stop commenting, too many comments, remove the comments, no comments, comment noise, the code is over-commented, or asks for clean code without narration. Also apply automatically while writing new code in any language, and when reviewing generated code before commit.
finestructure-ai/humanizer-multilingual · ★ 0 · AI & Automation · score 72
Install: claude install-skill finestructure-ai/humanizer-multilingual
# Comment hygiene Generated code narrates itself. `// Load the config` above the line that loads the config. `// Increment counter` above `i++`. The instruction to stop is given and then quietly dropped a turn later, which is the actual complaint: it is not that the rule is unknown, it is that it does not survive. So this skill is written as a decision procedure you run per comment, not as a preference you try to hold in mind. ## The test For every comment, ask one question: > If I delete this line, what does the reader lose? - **Nothing.** Delete it. - **The reason it is written this way.** Keep it. That is the whole rule. Everything below is that rule applied. ## Delete on sight | Comment | Why it goes | | --- | --- | | `// Load the config` above config loading | restates the code | | `// Increment counter` above `i++` | restates the code | | `// Constructor` above the constructor | restates the syntax | | `// Returns the user` above `return user` | restates the return | | `// Import React` above the import | restates the import | | `// Handle the error` above the catch block | restates the block | | `// Loop through items` above the loop | restates the loop | | `// Set the state` above a setter | restates the call | | `// TODO: implement` on implemented code | stale, and lies | | `// ===== SECTION =====` banners | if the file needs signposts, split the file | | `/** @param {string} name The name */` | restates the signature with no added fact | | A comment transla