crispy-comments

An Agent Skill written to curb coding agent's fine-tuned preference for narrating their inner chain-of-thought while writing code.

Based on this tweet

Lot of lambda in:

"For each code comment, ask: does this help future maintainers understand the code, or merely explain today’s bug fix? Remove incidental history, persuasive rationale, and correctness arguments."

— Danver Braganza (@404Cause) May 26, 2026

Install

curl -fsSL https://raw.githubusercontent.com/DanverImbue/crispy-comments/main/install.sh | bash

This drops SKILL.md into ~/.claude/skills/crispy-comments/ (override with AGENT_SKILLS_DIR).

Usage

In your coding agent, invoke it with:

/crispy-comments

It applies only to the current branch of the current repository.