Optimizes code readability by applying self-documenting principles and high-value documentation standards.
This skill helps developers maintain clean, professional codebases by prioritizing self-documenting code over excessive inline commentary. It provides Claude with a framework to audit existing documentation, identify redundant comments that merely restate logic, and ensure that any remaining annotations explain the underlying 'why' rather than the 'what.' By enforcing standardized TODO formats and providing actionable refactoring patterns, this skill transforms cluttered files into clear, maintainable source code that relies on type systems and expressive naming.
主要功能
01Identifies refactoring opportunities to eliminate the need for comments
0262 GitHub stars
03Enforces 'Why, not What' documentation principles for complex logic
04Audits inline documentation for redundancy and clutter
05Documents critical edge cases and external context (RFCs, Jira tickets)
06Standardizes TODO formats with mandatory ticket references
使用场景
01Refactoring complex logic into self-explanatory variables and function names
02Ensuring new features meet professional documentation standards during development
03Cleaning up legacy codebases with stale or misleading comments
