← ClaudeAtlas

clean-code-commentslisted

Remove or shorten redundant source-code comments without changing behavior. Use for explicit comment cleanup or dry audits of user-specified files and directories; do not use for general refactoring, documentation generation, or generated-output cleanup.
ValentinNikolaev/agent-skills · ★ 0 · AI & Automation · score 70
Install: claude install-skill ValentinNikolaev/agent-skills
<!-- GENERATED BY generate_skill_wrappers.py; DO NOT EDIT MANUALLY. --> ## Generated Codex skill — do not edit manually This complete skill and its bundled resources are generated from `agent-plugins/skills/clean-code-comments/SKILL.md`. Manual changes in this directory will be overwritten the next time the generator runs. Edit the canonical skill instead. # Clean Code Comments Reduce comment noise while preserving intent, constraints, public contracts, tool directives, and non-obvious behavior. ## Require an explicit scope Accept one or more files or directories. If none are supplied, ask for them before editing. Resolve relative paths from the repository root unless the user specifies another base. Resolve real paths and confirm every target remains inside the authorized scope and repository. Do not follow a symlink to edit content outside that boundary. When the user requests `--dry-audit`, classify and report opportunities without editing files. ## Capture the baseline Before classification or editing: 1. verify every target exists and identify file versus directory scopes; 2. read repository and path-scoped instructions; 3. record the starting commit, `git status --short`, and the existing diff for target paths; 4. identify source languages, documentation rules, linters, formatters, generated markers, and tool-interpreted comments; 5. inventory skipped binary, generated, vendored, third-party, minified, compiled, cached, and inaccessible files. Treat pre-exist