comment-rot-analyzer

A code-review skill that finds comments, TODOs, and documentation that no longer match the code. TODOs are notes about unfinished work, while documentation explains how code is supposed to behave.

In plain words
What is it for?
Use it after refactors, during code reviews, or as a maintenance check. It examines stale TODOs, inaccurate comments, and outdated API or project documentation.
Why use it?
Outdated comments can mislead developers into making incorrect changes. The skill checks whether notes, function descriptions, and README sections still reflect the project.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/random6913/claude-code-superkit/comment-rot-analyzer
Any agent
npx skills add RaNDoM6913/claude-code-superkit --skill comment-rot-analyzer
Clone the repo
git clone --depth 1 https://github.com/RaNDoM6913/claude-code-superkit

Made for: Claude Code, Codex.

Per session 23 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 553 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00023 $0.00553
Opus 5 $0.00012 $0.00277
Sonnet 5 $0.00005 $0.00111
Haiku 4.5 $0.00002 $0.00055

Measured yesterday against content hash bff342efaebe, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

comment-rot-analyzer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packages/codex/skills/comment-rot-analyzer/SKILL.md · 75 lines

How it starts

The opening of the file, as written. The whole thing — 75 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Comment Rot Analyzer

Detect comments that no longer match the code they describe. Stale comments are worse than no comments -- they actively mislead developers.

Phase 0: Load Project Context

Read if exists:

  1. AGENTS.md or CLAUDE.md -- project conventions
  2. Recent git log (git log --oneline -10) -- understand recent changes

When to Use

  • During the review-orchestrator pipeline -- dispatched for any changed files
  • After major refactors -- comments likely stale
  • Periodic codebase health check

Detection Checklist

1. Stale TODOs

Search for TODO/FIXME/HACK/XXX comments. For each:

  • Is it older than 6 months? (check git log -1 --format=%ai -- <file>)
  • Does the TODO reference a ticket/issue? Is it still open?
  • Is the TODO about code that was already changed?

2. Lying Comments

For each comment near changed code:

  • Does the comment describe what the code ACTUALLY does?
  • Was the code changed but the comment left unchanged?
  • Does the function/method doc match the current signature and behavior?

3. Outdated Documentation

  • Do README sections match current file structure?
  • Do API doc comments match actual request/response shapes?
  • Do "Returns:" doc comments match actual return types?

4. Dead References

  • Comments referencing deleted files, removed functions, or renamed variables
  • Links to URLs that no longer work (don't fetch -- just flag suspicious patterns)
  • References to deprecated APIs or removed features

Output Format

Severity

  • WARNING -- Comment actively misleads (says X, code does Y)
  • SUGGESTION -- Comment is stale but not dangerous (old TODO, vague description)

Format

[SEVERITY] file:line -- description
  Comment: "the comment text"
  Reality: what the code actually does
  Fix: update/remove the comment

Summary

## Comment Rot Report

Scanned: N files
Stale TODOs: X (Y older than 6 months)
Lying comments: X
Dead references: X
Total: N findings (W warnings, S suggestions)

Read the full file on GitHub · 75 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 75 lines · 23 tokens per session scan A bff342efaebe

Subscribe to this mod's changes

comment-rot-analyzer is a skill published in the GitHub repository RaNDoM6913/claude-code-superkit (2 stars, last pushed 1mo ago), licensed MIT. It adds 23 tokens to every session and 553 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

apm-review-panel

Use this skill to run a multi-persona expert advisory review on a labelled pull request in microsoft/apm. The panel fans out to five mandatory specialists plus a test-coverage specialist (active on every PR that touches src/) plus three conditional specialists (auth, doc-writer, performance-expert), all running in…

microsoft/apm · 178 tokens

apm-issue-autopilot

Use this skill to drive any open microsoft/apm issue (bug, feature, docs, refactor, perf) from raw intake to a mergeable PR with triage as the central, paramount gate. Run the apm-triage-panel rubric per issue first, then present ONE consolidated triage review for the whole batch and escalate to the maintainer BY…

microsoft/apm · 238 tokens

apm-spec-guardian

Use this skill to run a four-panel adversarial advisory review on any pull request that touches the OpenAPM specification artifact (docs/src/content/docs/specs/openapm-.md), its inline / sidecar JSON Schemas (docs/src/content/docs/specs/schemas/.schema.json), or the conformance fixture seed…

microsoft/apm · 215 tokens

apm-triage-panel

Use this skill to triage one microsoft/apm issue selected by the daily sweep, the status/needs-triage fast path, or manual dispatch. Emit one synthesized comment with a decision, label set, exact milestone, and suggested next action.

microsoft/apm · 59 tokens

batch-bug-shepherd

Use this skill to drive a batch of suspected bugs in microsoft/apm from raw issue list to mergeable PR queue. Fan out one triage subagent per issue (LEGIT / UNCLEAR / FIXED-AT-HEAD), gate every legit bug against PRINCIPLES.md via an apm-ceo strategic-alignment pass, cross-reference legit issues against open PRs, then…

microsoft/apm · 227 tokens

cli-logging-ux

Use this skill when editing or creating CLI output, logging, warnings, error messages, progress indicators, or diagnostic summaries in the APM codebase. Activate whenever code touches console helpers (richsuccess, richwarning, richerror, richinfo, richecho), DiagnosticCollector, STATUSSYMBOLS, CommandLogger, or any…

microsoft/apm · 94 tokens