mkober

Code Comments — Development skill for Claude Code

Development community

Keep comments minimal and structurally invisible — code shape comes first, rationale lives at the boundary, delete the rest.

How to install Code Comments

Installs to ~/.claude/skills/mkober-muxcode-code-comments/SKILL.md

Terminal

mkdir -p ~/.claude/skills/mkober-muxcode-code-comments && curl -fsSL https://raw.githubusercontent.com/mkober/muxcode/HEAD/skills/code-comments.md -o ~/.claude/skills/mkober-muxcode-code-comments/SKILL.md

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

What Code Comments does

name: code-comments description: Keep comments minimal and structurally invisible — code shape comes first, rationale lives at the boundary, delete the rest roles: [edit, review] tags: [style, comments, readability]

Comment discipline

**When to apply this.** Before every `Edit`/`Write` that adds a comment, re-read your own added lines against the rules below — not the file's existing comments, the ones you just wrote. This is an authoring step, not only a review standard: the fail