A Claude Code skill that prunes code comments down to what actually helps future maintainers.
It reviews the comments added or changed on the current branch's diff and removes:
- incidental history, defensive justification, and correctness arguments
- comments that restate facts likely to change (subclass counts, variant lists, call sites)
- commented-out code (version control already remembers it)
- ASCII-art banners and box-drawing section dividers
curl -fsSL https://raw.githubusercontent.com/DanverImbue/crispy-comments/main/install.sh | bash
This drops SKILL.md
into ~/.claude/skills/crispy-comments/
(override with CLAUDE_SKILLS_DIR
).
In Claude Code, invoke it with:
/crispy-comments
It applies only to the current branch of the current repository.
source & further reading
github.com — original article