Audit comments and docstrings for misleading or redundant content.
npx skills add https://github.com/JHostalek/dotclaude --skill audit-comments
Please help me install this Agent Skill. Skill: audit-comments Source: https://github.com/JHostalek/dotclaude/tree/main/skills/audit-comments Command: npx skills add https://github.com/JHostalek/dotclaude --skill audit-comments
This Skill helps identify comments, docstrings, and embedded documentation that are stale, misleading, redundant, or bloated while preserving prose that communicates important system constraints.
Use the audit-comments skill to review comments and docstrings throughout the specified path, preserving only accurate and consequential documentation.
High-intent search queries and answers about installing and using this skill.
To remove stale comments and misleading docstrings during a code review, audit the codebase to classify issues as confirmed defects or improvements, applying the smallest safe behavior-preserving edits while retaining consequential system intent.
Auditing technical debt in code documentation without losing system constraints requires top-down system reconstruction to separate misleading, bloated prose from vital architecture, lifecycle behavior, and domain rules before applying safe edits.
Identify missing documentation for public APIs and domain rules by performing an architecture-aware review that examines state transitions, operations, and tooling directives, then explicitly reporting documentation gaps and unresolved questions.
Yes, you can review embedded documentation prose to reduce bloat while preserving security and concurrency rationale by evidence-backing findings, recommending minimal safe corrections, and excluding unrelated modifications through explicit reporting.
You should not use an automated documentation audit when a codebase lacks established architectural boundaries, as the review requires top-down system reconstruction to accurately distinguish consequential system intent from redundant comments.
VMRam95Analyze directory structures and source code to generate hierarchical documentation and architectural maps.
kdlbsSimplify recently changed code by inlining abstractions, removing dead code, and adding guard clauses.
dt418Build documentation platforms with versioned docs, search, navigation, code highlighting, and API reference generation.
luispabonCrawl codebase directories to identify technical debt and code smells.
