ln-610-code-comments-auditor

Audit code comments and docstrings across six quality categories with compliance scores.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/cbbkrd-tech/jl-finishes --skill ln-610-code-comments-auditor-cbbkrd-tech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ln-610-code-comments-auditor
Source: https://github.com/cbbkrd-tech/jl-finishes/tree/main/.claude/skills/ln-610-code-comments-auditor
Command: npx skills add https://github.com/cbbkrd-tech/jl-finishes --skill ln-610-code-comments-auditor-cbbkrd-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common issue of poor-quality, unhelpful, or outdated code comments and docstrings, which can lead to confusion, maintenance difficulties, and bugs.

Core Features & Use Cases

  • Comprehensive Audit: Analyzes comments and docstrings across six critical categories: WHY-not-WHAT, Density, Forbidden Content, Docstrings Quality, Actuality, and Legacy Cleanup.
  • Scoring & Findings: Provides a compliance score per category and detailed findings with recommended actions.
  • Universal Applicability: Works with any programming language by auto-detecting comment syntax.
  • Use Case: After a major refactoring effort, use this Skill to ensure all new and existing code comments accurately reflect the current state of the codebase and adhere to best practices.

Quick Start

Run the code comments auditor skill on the current project directory.

Frequently Asked Questions about ln-610-code-comments-auditor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit code comments for quality and maintainability?

You can audit code comments by analyzing them across six categories: WHY-not-WHAT, Density, Forbidden Content, Docstrings Quality, Actuality, and Legacy Cleanup. This generates a compliance score per category and lists findings with recommended actions for improving clarity.

Does the code comments auditor work with any programming language?

Yes, the code comments auditor supports universal application across any programming language. It achieves this by auto-detecting the comment syntax, allowing you to audit docstrings and comments in diverse codebases without manual configuration.

How do I check for outdated code comments after a major refactoring effort?

To check for outdated code comments after refactoring, audit the Actuality and Legacy Cleanup categories. This evaluates whether existing comments accurately reflect the current state of the codebase and identifies unhelpful or outdated documentation.

What is the WHY-not-WHAT code comment analysis?

WHY-not-WHAT code comment analysis is an auditing category that evaluates whether comments explain the reasoning behind the code rather than merely restating what the code does. It helps improve code maintainability and clarity for developers.

Can I scan for forbidden content and excessive code comment density?

Yes, you can scan for forbidden content and evaluate code comment density. The auditing process checks comments across six critical categories, providing a compliance score and detailed findings to ensure your documentation adheres to best practices.