clean-comments

Remove redundant code comments while preserving architectural explanations.

1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/dopiotrek/dotclaude --skill clean-comments-dopiotrek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-comments
Source: https://github.com/dopiotrek/dotclaude/tree/main/skills/clean-comments
Command: npx skills add https://github.com/dopiotrek/dotclaude --skill clean-comments-dopiotrek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines codebases by removing unnecessary, redundant, or obvious comments, enhancing readability and maintainability without losing crucial explanations.

Core Features & Use Cases

  • Comment Reduction: Identifies and removes comments that merely restate code functionality.
  • Value Preservation: Retains comments that explain complex logic, business rules, or architectural decisions.
  • Conciseness: Simplifies verbose documentation for classes and functions.
  • Use Case: After developing a complex feature, use this Skill to clean up the inline comments and function docstrings, making the code easier for your team to review and understand.

Quick Start

Use the clean-comments skill to refine the comments in the attached file 'main.py'.

Frequently Asked Questions about clean-comments

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I remove redundant code comments automatically?

To remove redundant code comments automatically, this Skill identifies and deletes extraneous inline notes that merely restate functionality, simplifying verbose documentation to enhance readability and maintainability for code review.

Does cleaning up code comments affect architectural context?

Cleaning up code comments does not affect architectural context because the process preserves valuable explanations of complex logic, business rules, and architectural decisions while targeting only self-evident or redundant notes.

What is the best way to prepare code for review by improving readability?

The best way to prepare code for review by improving readability is to reduce comment noise, simplifying verbose docstrings and eliminating self-evident inline notes so reviewers can focus on essential logic.

Can I simplify verbose function docstrings without losing crucial explanations?

You can simplify verbose function docstrings without losing crucial explanations by using this Skill to target redundant documentation, condensing it while retaining comments that explain complex logic or business rules.

When should I avoid removing inline comments during refactoring?

You should avoid removing inline comments during refactoring when those comments explain complex architectural decisions, business rules, or non-obvious logic, as this Skill preserves them while stripping purely self-evident notes.