AI Skill MartBrowse skillsPromptsProgramsLearnWhat is a Skill?
 
← Back to list

Comment Quality Reviewer

Finds temporal and changelog-style language in code comments ("new", "now", "improved") and rewrites them to describe what the code does and why.

Dev & CodingIntermediate★ 446⑂ 51AI score 9/10Last updated: Nov 3, 2026

What it does

  • Scans comments in .go, .py, .js, .ts, .md, and .txt files for temporal words (new, old, now, recently, latest), development activity (added, fixed, refactored), state transitions (migrated, deprecated), and relative comparisons (better than, instead of).
  • Filters false positives such as copyright/license headers, @generated markers, variable names, and string literals.
  • Runs a gated four-phase workflow: SCAN → ANALYZE → REWRITE → REPORT, reading surrounding code before proposing rewrites.
  • Rejects rewrites that merely delete a temporal word; every suggestion must add concrete WHAT/WHY substance.
  • Produces a report with file path, line number, current text, suggested text, and reasoning; applies edits only when auto-fix is explicitly requested.

Who it's for

  • Developers inheriting an older codebase full of changelog-style comments
  • Tech leads standardizing comment conventions across a team
  • Anyone cleaning up READMEs and docs in Go/Python/JS/TS projects

Examples

  1. "Review comments in src/auth" → get a report turning // Authentication now uses JWT tokens into // Authenticates requests using signed JWT tokens.
  2. "Find stale comments and fix them automatically" → full scan, quality-checked rewrites, then batch Edit application.
  3. Clean a README by replacing "improved in the latest version" with a description of the actual behavior so docs don't age.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/notque/vexjoy-agent/HEAD/skills/code-quality/comment-quality/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on AI Skill Mart.
Copy the skills/code-quality/comment-quality folder from the GitHub repo notque/vexjoy-agent into my ~/.claude/skills/comment-quality/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/notque/vexjoy-agent.git && mkdir -p ~/.claude/skills && cp -r vexjoy-agent/skills/code-quality/comment-quality ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the repository: git clone https://github.com/notque/vexjoy-agent.git
  3. Create the skills directory: mkdir -p ~/.claude/skills
  4. Copy the skill: cp -r vexjoy-agent/skills/code-quality/comment-quality ~/.claude/skills/
  5. Verify the references/ files came along: ls ~/.claude/skills/comment-quality
  6. Restart Claude Code, then ask something like "review comments in this directory". Say "auto-fix them" explicitly if you want edits applied.
View source on GitHub ↗License: MIT