Global Commenting

This Skill provides Claude Code with specific guidance on how to adhere to coding standards as they relate to how it should handle global commenting.

When to use this skill

• When writing any new code that might require comments or explanations
• When refactoring code to improve clarity through better naming and structure
• When deciding whether to add comments to complex logic or algorithms
• When removing outdated, temporary, or change-related comments from code
• When reviewing existing comments to ensure they remain relevant and evergreen
• When writing function or method documentation
• When explaining non-obvious business logic or architectural decisions
• When working with any code file in any programming language
• When ensuring code is self-documenting through clear variable and function names
• When avoiding comments that simply describe what the code does (prefer explaining why)

Instructions

For details, refer to the information provided in this file: global commenting