comment-quality

Name: comment-quality
Availability: InStock
Author: notque

Detect temporal wording in code comments and generate timeless rewrites with a structured report.

415|44|Updated Mar 18, 2026

Search Tags:#documentation #maintainability #code-review #rewriting #comment-quality #temporal-language

Ready to run

npx skills add https://github.com/notque/claude-code-toolkit --skill comment-quality

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: comment-quality
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/comment-quality
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill comment-quality

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Temporal language in code comments hampers long-term maintainability and clarity, especially as projects evolve. This Skill detects such language and provides timeless, actionable rewrites that focus on current behavior and rationale.

Core Features & Use Cases

Detects temporal words like new, old, now, updated, or other development-activity terms in comments across languages.
Suggests precise rewrites that explain WHAT the code does and WHY it matters, improving readability and future-proofing.
Produces a structured report with file paths, line numbers, current text, and suggested rewrites, suitable for code reviews and pre-release audits.

Quick Start

Provide a path or set of files to scan, and I will identify temporal language in comments, generate timeless rewrites, and return a structured report.

Frequently Asked Questions about comment-quality

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

FAQPage Schema

How do I find and fix temporal language in code comments?▼

To fix temporal language in code comments, scan targeted files or directories to detect temporal, development-activity, and relative wording. The process produces a structured findings report with file paths, line numbers, and precise timeless rewrites describing what the code does and why.

Why do temporal words in comments hurt long-term maintainability?▼

Temporal words like new, old, or now hurt maintainability because they become stale as projects evolve. Rewriting them into timeless comments that explain current behavior and rationale ensures documentation remains accurate and clear for future code reviews.

How do I scan specific files or directories for outdated wording in code comments?▼

Provide a file path or set of files to scan. The scanner analyzes comments across common languages, identifies temporal and relative wording, and returns a structured report containing file paths, line numbers, current text, and suggested timeless replacements.

Does this comment rewriting tool work across multiple programming languages?▼

Yes, the comment rewriting tool works across common programming languages. It scans comments regardless of language to identify temporal and development-activity terms, generating precise rewrites and a structured findings report suitable for pre-release audits.

What is the best way to prepare code comments for a pre-release audit?▼

The best way to prepare comments for a pre-release audit is scanning the codebase to identify temporal language. This generates a structured report with exact line numbers and replacement suggestions that describe what the code does, ensuring documentation is timeless and clear.