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 |

Auditez la qualité des commentaires du code et des docstrings dans 6 catégories (POURQUOI-pas-QUOI, Densité, Contenu interdit, Docstrings, Actualité, Héritage). À utiliser lorsque le code nécessite une révision des commentaires, après une refactorisation majeure ou dans le cadre du pipeline ln-100-documents. Résultats Score de conformité X/10 par catégorie + Constatations + Actions recommandées. Source : levnikolaevich/claude-code-skills.

Voir l'original