skills.rest
devmatrix-ai
devmatrix-aiCOMMUNITY
Explore all skills by this author →
GitHub

Global Commenting

Guide comment placement and promote self-documenting code during reviews.

Updated Aug 23, 2026
Search Tags:#code quality#best practices#documentation#readability#maintainability#comments#self-documenting
One-click install
npx skills add https://github.com/devmatrix-ai/devmatrix-mvp --skill global-commenting-devmatrix-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Global Commenting
Source: https://github.com/devmatrix-ai/devmatrix-mvp/tree/main/.claude/skills/global-commenting
Command: npx skills add https://github.com/devmatrix-ai/devmatrix-mvp --skill global-commenting-devmatrix-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Over-commented or outdated comments create noise and confusion, while under-commented complex logic makes code hard to understand. This Skill promotes effective, minimal commenting, leading to more readable and maintainable code.

Core Features & Use Cases

  • Guides Comment Placement: Advises on when and where comments are truly necessary.
  • Promotes Self-Documenting Code: Encourages clear naming and structure to reduce the need for comments.
  • Ensures Evergreen Comments: Focuses on comments that remain relevant over time, avoiding temporal notes.
  • Use Case: When reviewing a complex algorithm, use this Skill to add concise comments only where the logic is not immediately obvious, ensuring variable names are self-explanatory.

Quick Start

Refactor the calculate_tax function to be more self-documenting, and add a single, concise comment explaining the complex tax bracket logic.