levnikolaevich avatar

Ln 613 Code Comments Auditor

Audits inline code documentation across six dimensions: whether comments explain WHY instead of restating WHAT, comment density (targeting 15-20%), forbidden content like author names and dates, docstring accuracy against actual signatures, whether comments match current code behavior, and legacy cruft like uncommented TODOs or commented-out code blocks. Built as an L3 worker that scans your codebase, flags violations with severity and line numbers, calculates a compliance score out of 10, and writes a structured markdown report. Works across any language by auto-detecting comment syntax. Use this when you want programmatic enforcement of documentation standards without manual review, or when auditing a codebase before handoff or open-sourcing.

skills.sh installs
259
GitHub stars
591
last updated
Aug 21, 2026

Install

$ npx -y skills add levnikolaevich/claude-code-skills --skill ln-613-code-comments-auditor --agent claude-code

Installs into .claude/skills of the current project.

Files

Audits inline code documentation across six dimensions: whether comments explain WHY instead of restating WHAT, comment density (targeting 15-20%), forbidden content like author names and dates, docstring accuracy against actual signatures, whether comments match current code behavior, and legacy cruft like uncommented TODOs or commented-out code blocks. Built as an L3 worker that scans your codebase, flags violations with severity and line numbers, calculates a compliance score out of 10, and writes a structured markdown report. Works across any language by auto-detecting comment syntax. Use this when you want programmatic enforcement of documentation standards without manual review, or when auditing a codebase before handoff or open-sourcing.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/levnikolaevich/claude-code-skills
Categories
Documentation, Code Review & Quality
First seen
Jun 3, 2026

More from levnikolaevich/claude-code-skills

All 128
1woocommerce avatarwoocommerce-copy-guidelineswoocommerce/woocommerceGuidelines for UI text and copy in WooCommerce. Use when writing user-facing text, labels, buttons, or messages.259skills.sh installs
2brettatoms avataralpinejsbrettatoms/agent-skillsAlpineJS best practices and patterns. Use when writing HTML with Alpine.js directives to avoid common mistakes like long inline JavaScript strings.258skills.sh installs
3daffy0208 avatarcopywriterdaffy0208/ai-dev-standardsExpert in writing compelling copy for web, marketing, and product257skills.sh installs
4pproenca avatareffect-tspproenca/dot-skillsEffect-TS library usage in TypeScript — Effect.gen generators, Schema.Struct/Schema.Class definitions, Layer/Context.Tag/Service patterns, Effect.pipe pipelines257skills.sh installs
5wispbit-ai avatarrust-expert-best-practices-code-reviewwispbit-ai/skillsRust best practices and code quality guidelines for writing idiomatic, safe, and performant Rust code. This skill should be used when writing, reviewing, or ref257skills.sh installs
6pproenca avatarnginx-c-module-debugpproenca/dot-skillsnginx C module debugging guidelines based on the official nginx development guide. This skill should be used when debugging nginx C module crashes, memory bugs,253skills.sh installs