zieka

Reduce Comments — Documentation skill for Claude Code

Documentation community

Cut new code comments down to what earns its place — why over what, inline over doc blocks, standard labels.

How to install Reduce Comments

Installs to ~/.claude/skills/zieka-ike-reduce-comments/SKILL.md

Terminal

mkdir -p ~/.claude/skills/zieka-ike-reduce-comments && curl -fsSL https://raw.githubusercontent.com/zieka/ike/HEAD/commands/reduce-comments.md -o ~/.claude/skills/zieka-ike-reduce-comments/SKILL.md

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

What Reduce Comments does

description: Cut new code comments down to what earns its place — why over what, inline over doc blocks, standard labels.

of the new code lets reduce the word count on the code comments.

if the code is already self explanitory we might not need a comment. In most cases we dont because we can refrence git history and pull request history.
If a code comment is necessary, prefer an inline comment over a doc block unless you are documenting a public API (function, class, module, etc.)

Alternatives in Documentation

Docx — Create, edit, and analyze Word documents with tracked changes, comments, and formatting 94.1k ★
Translate Doc Zh — Translate English documentation to Chinese 5.7k ★
Review Docs — Review and improve documentation (docstrings and comments) in a file 2.3k ★