Name: Global Commenting
Author: GreyssonEnterprises

When to use this skill

When deciding whether code needs comments or can be made self-explanatory through better naming
When writing comments for complex algorithms or business logic that isn't immediately obvious
When removing temporal comments like "fixed bug yesterday" or "TODO: refactor later"
When reviewing existing comments to ensure they're still accurate and evergreen
When explaining WHY code makes a particular decision rather than WHAT it does
When documenting large sections of code logic with concise, helpful summaries
When avoiding redundant comments that just restate what the code obviously does
When refactoring code to eliminate the need for explanatory comments through clarity
When adding comments to configuration files explaining non-obvious settings
When documenting workarounds for third-party library quirks or platform limitations
When ensuring comments will remain relevant months or years into the future

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 deciding whether code needs comments or can be made self-explanatory through better naming
When writing comments for complex algorithms or business logic that isn't immediately obvious
When removing temporal comments like "fixed bug yesterday" or "TODO: refactor later"
When reviewing existing comments to ensure they're still accurate and evergreen
When explaining WHY code makes a particular decision rather than WHAT it does
When documenting large sections of code logic with concise, helpful summaries
When avoiding redundant comments that just restate what the code obviously does
When refactoring code to eliminate the need for explanatory comments through clarity
When adding comments to configuration files explaining non-obvious settings
When documenting workarounds for third-party library quirks or platform limitations
When ensuring comments will remain relevant months or years into the future

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.