robertsolves

Find Bad Comments — Development skill for Claude Code

Development community

Find comments that mislead or waste the reader — claims the code no longer backs (numbers, dates, history, invariants), descriptions of old behaviour, comments that restate the code, undefined jargon.

How to install Find Bad Comments

Installs to ~/.claude/skills/robertsolves-agent-commands-find-bad-comments/SKILL.md

Terminal

mkdir -p ~/.claude/skills/robertsolves-agent-commands-find-bad-comments && curl -fsSL https://raw.githubusercontent.com/robertsolves/agent-commands/HEAD/commands/find-bad-comments.md -o ~/.claude/skills/robertsolves-agent-commands-find-bad-comments/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Find Bad Comments does

description: Find comments that mislead or waste the reader — claims the code no longer backs (numbers, dates, history, invariants), descriptions of old behaviour, comments that restate the code, undefined jargon, backstory essays — and the places a why-comment is missing, verify each against the code and git history, ask which to fix, then rewrite or delete them. Run after a big refactor, before handing code to a new reader, or as periodic hygiene. argument-hint: "[path or area to focus on]

Alternatives in Development

Opik Openclaw — 🦞 Official plugin for OpenClaw that exports agent traces to Opik 725 ★
React Native Restate — Build a full-stack Real Estate app from scratch with Google Authentication, dynamic routing, and more 678 ★
Undefined — QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11 262 ★