Skip to content
Back to skills

Comment Cleanup

ASecurity

Guidelines for comments in code. Use when adding, editing, or removing comments.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added September 27, 2026
documentationapi

Works with

  • api

Security analysis

A100/100

Scanned September 27, 2026

npx -y skills add David-Li0406/meta-skill-evloving --skill comment-cleanup --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Comment Cleanup?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Comment Cleanup
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/david-li0406-comment-cleanup/badge)](https://www.skillsdirectory.com/skills/david-li0406-comment-cleanup)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: comment-cleanup
description: Guidelines for comments in code. Use when adding, editing, or removing comments.
---

# Comment Guidelines

- Use comments sparingly
- Don't comment out code
  - Remove it instead
- Don't add comments that describe the process of changing code
  - Comments should not include past tense verbs like added, removed, or changed
  - Example: `this.timeout(10_000); // Increase timeout for API calls`
  - This is bad because a reader doesn't know what the timeout was increased from, and doesn't care about the old behavior
- Don't add comments that emphasize different versions of the code, like "this code now handles"
- Do not use end-of-line comments
  - Place comments above the code they describe

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…