What kind of comments does it add?

It adds module-level summaries, class/function responsibilities (arguments, returns, exceptions), and inline comments for complex logic blocks or edge cases.

Does this skill change my code's behavior?

No, the skill is strictly constrained to adding comments and docstrings. It performs a self-check to ensure no imports, logic, or variable names are altered.

How does it handle existing docstrings?

It respects existing documentation and only appends missing information to avoid redundancy while maintaining the original style where possible.

Does it work with languages other than Python?

This specific skill is optimized for Python (.py) files to ensure accurate parsing of docstrings and PEP 8 standards.

Python Code Commentator

Name: Python Code Commentator
Author: tyhts0829

bytyhts0829

Aprendizaje y Documentación

Enhances Python code readability by adding comprehensive docstrings and explanatory comments without altering program logic.

Acerca de

The comment-detailed skill is a specialized tool for developers who need to quickly understand or document complex Python scripts. It systematically analyzes a file's responsibilities, I/O, and side effects to generate high-quality module-level docstrings, function descriptions, and inline comments. Unlike standard formatters, it focuses on the 'why' behind the code—explaining intent, constraints, and edge cases—ensuring that the script remains 100% behaviorally identical while becoming significantly easier to maintain and audit.

Características Principales

Adds context-aware inline comments explaining logic intent and constraints
Identifies entry points, side effects, and global state interactions
Generates comprehensive module and function-level docstrings
Ensures zero changes to original code behavior or execution logic
Performs syntax verification via py_compile after adding documentation
0 GitHub stars

Casos de Uso

Onboarding new developers by making complex internal scripts self-explanatory
Documenting legacy Python codebases to simplify long-term maintenance
Preparing internal scripts for code review or public open-source release

Acerca de

Características Principales

Adds context-aware inline comments explaining logic intent and constraints
Identifies entry points, side effects, and global state interactions
Generates comprehensive module and function-level docstrings
Ensures zero changes to original code behavior or execution logic
Performs syntax verification via py_compile after adding documentation
0 GitHub stars

Casos de Uso

Onboarding new developers by making complex internal scripts self-explanatory
Documenting legacy Python codebases to simplify long-term maintenance
Preparing internal scripts for code review or public open-source release