Global Commenting

This Skill provides Claude Code with specific guidance on code commenting best practices, emphasizing self-documenting code and minimal, evergreen comments.

When to use this skill

• When writing code in any programming language and deciding whether to add comments
• When refactoring code to make it more self-explanatory through better naming and structure
• When removing outdated, temporary, or unnecessary comments
• When adding comments to explain complex logic or large code sections
• When choosing between adding a comment versus improving code clarity through naming
• When ensuring comments are evergreen and won't become outdated
• When avoiding comments that explain recent changes or temporary fixes
• When reviewing code and identifying where self-documenting improvements can replace comments
• When working with complex algorithms or business logic that genuinely needs explanation
• When maintaining clean, readable code without comment clutter
• When applying across all file types (.ts, .js, .py, .java, .go, .tsx, .jsx, .vue, .rb, etc.)

Instructions