# Comment Review Criteria > Source code comment review criteria. Defines what comments should explain and flags violations like design rationale, LLM traces, and redundant comments. Use when this capability is needed. - Skill: `tomevault-io/comment-review-criteria` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/comment-review-criteria` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/comment-review-criteria/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/comment-review-criteria --- ## Comment Review Criteria Source code comments should explain constraints affecting correctness, not design rationale. Flag as violations: - Design rationale (why this API/format/protocol was chosen) - LLM generation traces (AI/Claude mentions, "Generated by" markers) - Implementation history (belongs in commit messages) - Conversational tone - Redundant comments duplicating code --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/sato-dev1234) — claim your Tome and manage your conversions.