ln-610-code-comments-auditor

SKILL.md

Audit code comments and docstrings quality. Universal for any tech stack.

| 1 | WHY not WHAT | Comments explain rationale, not obvious code behavior; no restating code | | 2 | Density (15-20%) | Comment-to-code ratio within range; not over/under-commented | | 3 | No Forbidden Content | No dates/authors; no historical notes; no code examples in comments |

| 4 | Docstrings Quality | Match function signatures; parameters documented; return types accurate | | 5 | Actuality | Comments match code behavior; no stale references; examples runnable | | 6 | Legacy Cleanup | No TODO without context; no commented-out code; no deprecated notes |

Audite los comentarios de código y la calidad de las cadenas de documentos en 6 categorías (POR QUÉ-NO-QUÉ, Densidad, Contenido prohibido, Cadenas de documentos, Actualidad, Legado). Úselo cuando el código necesite revisión de comentarios, después de una refactorización importante o como parte de ln-100-documents-pipeline. Resultados Cumplimiento Puntaje X/10 por categoría + Hallazgos + Acciones recomendadas. Fuente: levnikolaevich/claude-code-skills.

Ver original