Reviews and rewrites code comments to keep them concise, accurate, and current.
npx skills add https://github.com/sndrgrdn/skills --skill code-comments-sndrgrdn
Please help me install this Agent Skill. Skill: code-comments Source: https://github.com/sndrgrdn/skills/tree/main/code-comments Command: npx skills add https://github.com/sndrgrdn/skills --skill code-comments-sndrgrdn
High-intent search queries and answers about installing and using this skill.
Remove comments that narrate what the code already expresses, such as restating a function name or describing obvious operations. Keep only comments that explain intent, invariants, tradeoffs, or interface contracts the code cannot convey on its own.
Write a comment only where the code does not make intent, ownership, invariants, tradeoffs, or interface contracts clear. If the code is self-explanatory, no comment is needed; prefer clearer naming or structure instead.
Yes, the guidance is language-agnostic because it governs comment content rather than syntax. It applies equally to Python, JavaScript, Go, Rust, or any other language's comment conventions.
Judging whether a comment captures true intent or a subtle invariant requires understanding the code's design context. Borderline comments explaining non-obvious business rules may still need human review before deletion.
mariariIdentify architectural misfits, dead code, and excessive complexity in code artifacts.
t-stringsEnforce global-commenting standards across source files and documentation during code reviews.
baphledEnforce coding standards and documentation conventions via linter configuration.
pdovhomiljaGenerate concise comments explaining complex logic in code files.
