agentsclimarketplace
Sign in

Audit comments

Skill JHostalek/dotclaude/skills/audit-comments

Use when auditing comments, docstrings, or embedded documentation prose in a scope — to strip bloat and rewrite cluttered-but-justified entries. Triggers on "audit comments", "clean up docstrings", "strip stale comments", "comment cleanup".From its SKILL.md

Install
npx -y skills add JHostalek/dotclaude --skill audit-comments

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 10 stars10 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
  • runs commandsInstructs the agent to run 1 command, including `cat "${CLAUDE_SKILL_DIR}/../audit-workflow.md"`.

SKILL.md

1.4 KB, 237 tokens by cl100k_base, as published. Nobody here has run it

!cat "${CLAUDE_SKILL_DIR}/../audit-workflow.md"

Run as the comments dimension. Comments run last because structure, patterns, and correctness edits change what the code does — a comment accurate before those passes may be stale after them. Lens:

Strip comments that don't earn their place; rewrite those that do but bury the signal. Type annotations are primary documentation — every comment competes against the signature, body, and adjacent declarations. Survive only by carrying a WHY sourced from outside the codebase: cited bug, spec, third-party quirk, business rule, historical decision. Behavioral narration ("idempotent", "no-op when empty", "callers rely on X") → strip regardless of accuracy; the code is the source. Named symbols must resolve — a comment referencing a function or constant that no longer exists is wrong, not outdated; a cross-reference to the obvious call site earns nothing even when it resolves. Missing comment beats a wrong one — when torn, strip. Skip user-facing strings, log templates, generated code.

Strip/rewrite = auto-fix (prose only, code unchanged). Nothing here is sign-off.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.