al-af

Al Decomment — Development skill for Claude Code

Development community

Strip comments that narrate the next line or restate a name, keep the ones that explain why.

How to install Al Decomment

Installs to ~/.claude/skills/al-af-al-skills-al-decomment/SKILL.md

Terminal

mkdir -p ~/.claude/skills/al-af-al-skills-al-decomment && curl -fsSL https://raw.githubusercontent.com/al-af/al-skills/HEAD/commands/al-decomment.md -o ~/.claude/skills/al-af-al-skills-al-decomment/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Al Decomment does

description: Strip comments that narrate the next line or restate a name, keep the ones that explain why

Scope to the current diff by default, not the whole repo (that's `al-audit`'s territory if actually wanted — ask before widening).

Cut: narrates the next line (`// increment` above `i++`), restates the name (`// Calculates the total` above `calculateTotal()`), commented-out dead code, a stale TODO with no owner/ticket/date, param docs that only repeat the type signature.

Keep: expl

Alternatives in Development

Remove Comments — Remove Obvious Comments 2.8k ★
Comments — /comments Command 849 ★
Herdr Reviewr — Review your coding agent's diff in a terminal pane and send line comments back to Claude Code, Codex, OpenCode 823 ★