Global Code Commenting

关于

This skill ensures codebases remain clean and maintainable by guiding Claude to write minimal, evergreen comments that explain the reasoning behind complex decisions rather than stating the obvious. It prioritizes self-documenting code through meaningful naming and structure, helping developers eliminate outdated descriptions, temporary change notes, and redundant logic explanations. By focusing on why code exists instead of what it does, it ensures that every comment provides long-term value for business logic, algorithms, and non-obvious implementation details.

主要功能

• Prioritizes explaining intent and reasoning over describing basic code operations
• 0 GitHub stars
• Standardizes evergreen documentation for complex algorithms and business rules
• Encourages self-documenting code through meaningful variable and function naming
• Cleans up commented-out code and avoids change history in source files
• Identifies and removes redundant, outdated, or obvious comments

使用场景

• Documenting non-obvious business logic or architectural decisions during development
• Enforcing consistent coding standards across a project to ensure long-term maintainability
• Refactoring a complex codebase to improve readability and reduce comment clutter