What problem does it solve? Source code often ships with missing, stale, or process-laden docstrings and comments that confuse first-time readers. This Skill rewrites every docstring and comment to be self-contained, forward-facing, and consistent with the language's documentation dialect, without ever touching the code itself. ## Core Features & Use Cases - Docs-only diffs: Adds or fixes docstrings and comments while guaranteeing no code changes — signatures, imports, and logic stay untouched. - Language dialects: Applies NumPy style for Python, TSDoc for TypeScript/JavaScript, and rustdoc for Rust, with per-language public/internal rules and linter commands (ruff, eslint-plugin-jsdoc, cargo doc). - Comment triage: Deletes commented-out code, restatements, and decorative banners, and rewrites surviving comments to explain why rather than what. - Use Case: A team adopts a new Python codebase with undocumented modules. Run this Skill to give every public function a full NumPy-style docstring, trim internal helpers to one line, and clean the comment noise, then verify with ruff check --select D. ## Quick Start Use the update-docstrings skill to add NumPy-style docstrings to every function in src/parser.py and clean up its comments.
