Name: Global Commenting
Author: dpietersz

Global Commenting

Write self-documenting code with minimal, helpful comments that explain complex logic without documenting temporary changes or fixes. Use this skill when adding comments to code, documenting functions or classes, or explaining complex algorithms. When writing or editing any code file that may benefit from explanatory comments. When reviewing existing comments to ensure they remain evergreen and relevant. When deciding whether code needs comments or if better naming and structure would be clearer. This skill applies to all code files in any programming language including `.js`, `.ts`, `.py`, `.rb`, `.java`, `.go`, `.php`, and others.

dpietersz0 starsJan 16, 2026

Occupation
Categories: Automation Tools

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

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

Global Commenting

When to use this skill

Instructions

Global Commenting

When to use this skill

Instructions

Init

Coding Agent (bash-first)

Fix

Continuous Learning

Openclaw Release Maintainer

Verify