Claude Code clean-comments skill for trimming redundant inline comments
Review existing comments, remove lines that restate assignments, and preserve the reasoning a maintainer needs to interpret edge cases.
中文Install in Claude Code
Open an exercise checkout in Claude Code and select one Python file. Keep a baseline diff so you can inspect the comment-only changes for this exercise.
- Review `.claude/skills/clean-comments/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.claude/skills/clean-comments/` in your project and save the reviewed file as `.claude/skills/clean-comments/SKILL.md`.
- Start Claude Code from that project's root, then select `/clean-comments` in the slash menu.
Example task
Prepare a label-selection function with one comment restating assignment and another explaining why a fallback label helps assistive technology. Ask clean-comments to edit comments only.
`choose_label.py` · `label = raw_label or "Untitled"` · `# Assign the label`What to check
The diff removes `# Assign the label`, while preserving the accessibility rationale and `label = raw_label or "Untitled"`.
Original SKILL.md on GitHub · Updated
Frequently asked question
How do I tell which comment to keep?
Read the variable names and expressions first. Keep comments that explain meaningful constraints, compatibility choices, or behavior at an edge case.