clean-transient-comments

Use when the user asks to "clean transient comments", "remove temporary comments", or remove comments that describe past changes rather than documenting current code.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "clean-transient-comments" with this command: npx skills add iamkaf/skills/iamkaf-skills-clean-transient-comments

Remove comments that read like commit messages or dev notes about refactors.

Detection Heuristics

Flag comments that:

  • Use past tense or temporal words ("now", "was", "used to", "moved", "changed", "updated", "fixed")
  • Reference where code came from or went ("moved to X", "extracted from Y")
  • Explain that something changed rather than why it exists

Examples to remove:

  • // This is now done via mixin
  • // Moved to ItemFunctions.java
  • // Updated to use new API

Preserve

  • WHY explanations (rationale, edge cases, warnings)
  • TODO/FIXME with ongoing relevance
  • Ticket/issue references
  • Domain logic documentation

Process

Phase 1: Scan

Scan provided paths, or default to src/, lib/, and common source files.

Phase 2: Report

List files, specific comments planned for removal with context, and rationale.

Wait for approval before removing.

Phase 3: Remove

After approval, delete flagged comments. Preserve all code structure and formatting.

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

effective-questioning

No summary provided by upstream source.

Repository SourceNeeds Review
4-iamkaf
Security

ai-writing-audit

No summary provided by upstream source.

Repository SourceNeeds Review
3-iamkaf
General

amber

No summary provided by upstream source.

Repository SourceNeeds Review
3-iamkaf
Coding

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

Repository SourceNeeds Review
160.5K94.2Kanthropics