Global Commenting

When to use this skill

• When adding comments to any code file in any programming language
• When documenting complex logic or algorithms that aren't immediately obvious
• When writing or reviewing function/method documentation
• When explaining large sections of code that perform non-trivial operations
• When deciding whether to add a comment or refactor for clarity
• When reviewing existing comments to remove outdated or temporary notes
• When ensuring comments are evergreen and won't become stale
• When avoiding comments about recent changes, fixes, or temporary workarounds
• When prioritizing self-documenting code through clear naming and structure
• When writing minimal, concise comments that add value

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.

Instructions

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