# Ahonn Dotfiles Comment Cleanup

> Comment Cleanup

- Skill: `tomevault-io/ahonn-dotfiles-comment-cleanup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ahonn-dotfiles-comment-cleanup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ahonn-dotfiles-comment-cleanup/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ahonn-dotfiles-comment-cleanup

---


# Comment Cleanup

Analyze and improve documentation in the specified file following the Comment Standards defined in the `code-quality` skill.

## Target File

$ARGUMENTS

## Analysis Process

1. **Read the file** to understand its purpose and structure
2. **Identify naming improvements** that could make code more self-documenting
3. **Find complex logic** that needs explanation
4. **Locate design decisions** that should be documented
5. **Remove harmful comments** that add noise or are outdated
6. **Add strategic comments** where they reduce cognitive load

## Execution

1. Read and analyze the target file
2. Suggest and apply naming improvements if needed
3. Remove redundant or misleading comments
4. Add comments only where they:
   - Explain non-obvious behavior
   - Document design decisions
   - Clarify complex algorithms
   - Provide essential interface documentation
5. Leave code cleaner than found

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/ahonn) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->