# Stop coding agents from writing prolix comments

> Source: <https://github.com/DanverImbue/crispy-comments>
> Published: 2026-06-24 03:59:09+00:00

A [Claude Code](https://claude.com/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.