What problem does it solve? Codebases accumulate undocumented functions, missing docstrings, and stale comments that slow down onboarding and maintenance. This Skill runs a systematic, language-agnostic documentation audit that inventories every file, fills documentation gaps without changing code behavior, and produces a timestamped report. ## Core Features & Use Cases - Tiered Documentation Audit: Classifies files into four tiers (function libraries, script-embedded functions, pipeline scripts, configuration) and applies the right documentation strategy to each. - Gap Filling with Validation: Writes complete docstrings for every Tier 1/2 function, adds why-focused inline comments and section headers, then parse-checks every modified file. - Reporting and Issue Filing: Generates a timestamped report in docs/doc-reports/ and auto-files durable backlog issues for findings like missing or stale docstrings. - Use Case: Point it at a legacy module and ask it to audit documentation — it inventories all functions, adds missing docstrings in the project's existing style, fixes stale parameter docs, and files issues for anything it cannot fix in place. ## Quick Start Ask the assistant to audit the documentation in the src directory and add docstrings to any undocumented functions.
