Analyze and improve documentation in the specified file following the Comment Standards defined in the code-quality skill.
Target File
$ARGUMENTS
Analysis Process
Read the file to understand its purpose and structure
Identify naming improvements that could make code more self-documenting
Find complex logic that needs explanation
Locate design decisions that should be documented
Remove harmful comments that add noise or are outdated
Add strategic comments where they reduce cognitive load
Execution
Read and analyze the target file
Suggest and apply naming improvements if needed
Remove redundant or misleading comments
Add comments only where they:
Explain non-obvious behavior
Document design decisions
Clarify complex algorithms
Provide essential interface documentation
Leave code cleaner than found
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: ahonn-dotfiles-comment-cleanup3description: Comment Cleanup4---56# Comment Cleanup78Analyze and improve documentation in the specified file following the Comment Standards defined in the `code-quality` skill.910## Target File1112$ARGUMENTS1314## Analysis Process15161. **Read the file** to understand its purpose and structure172. **Identify naming improvements** that could make code more self-documenting183. **Find complex logic** that needs explanation194. **Locate design decisions** that should be documented205. **Remove harmful comments** that add noise or are outdated216. **Add strategic comments** where they reduce cognitive load2223## Execution24251. Read and analyze the target file262. Suggest and apply naming improvements if needed273. Remove redundant or misleading comments284. Add comments only where they:29 - Explain non-obvious behavior30 - Document design decisions31 - Clarify complex algorithms32 - Provide essential interface documentation335. Leave code cleaner than found3435---36> Converted and distributed by [TomeVault](https://tomevault.io/claim/ahonn) — claim your Tome and manage your conversions.37<!-- tomevault:4.0:skill_md:2026-04-11 -->
Run npx skillmds@latest add tomevault-io/ahonn-dotfiles-comment-cleanup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Comment Cleanup It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.
tomevault-io