{"id":"270c8ed3-62bc-4a3c-b3f1-a2f08ae58c88","shortId":"cJSAVD","kind":"skill","title":"audit-comments","tagline":"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\".","description":"target = $ARGUMENTS\n\nIf target provided, audit that path. Otherwise, files changed since the default branch. Full-codebase audit requires explicit user request.\n\nStrip comments that don't earn their place; rewrite those that do but bury the signal.\n\nType annotations are primary documentation; every comment competes against the signature, body, and adjacent declarations. A comment survives only by carrying a WHY sourced from outside the codebase — a cited bug, a spec, a third-party quirk, a business rule, a historical decision. Behavioral narration (\"idempotent\", \"no-op when empty\", \"callers rely on X\") fails the test no matter how accurate — the code is the source; strip it. Named symbols must resolve. A missing comment beats a wrong one — when torn, strip. Skip user-facing strings, log templates, and generated code.","tags":["audit","comments","dotclaude","jhostalek","agent-skills","ai-coding","anthropic","claude","claude-code","claude-code-skills","code-review","codex-cli"],"capabilities":["skill","source-jhostalek","skill-audit-comments","topic-agent-skills","topic-ai-coding","topic-anthropic","topic-claude","topic-claude-code","topic-claude-code-skills","topic-code-review","topic-codex-cli","topic-cursor","topic-developer-tools","topic-git-workflow","topic-multi-agent"],"categories":["dotclaude"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/JHostalek/dotclaude/audit-comments","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add JHostalek/dotclaude","source_repo":"https://github.com/JHostalek/dotclaude","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (828 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:13:14.199Z","embedding":null,"createdAt":"2026-05-18T13:20:30.113Z","updatedAt":"2026-05-18T19:13:14.199Z","lastSeenAt":"2026-05-18T19:13:14.199Z","tsv":"'accur':139 'adjac':90 'annot':78 'argument':39 'audit':2,6,28,43,56 'audit-com':1 'beat':154 'behavior':121 'bloat':18 'bodi':88 'branch':52 'bug':107 'buri':74 'busi':116 'caller':129 'carri':97 'chang':48 'cite':106 'clean':30 'cleanup':37 'clutter':22 'cluttered-but-justifi':21 'code':141,170 'codebas':55,104 'comment':3,7,29,35,36,62,83,93,153 'compet':84 'decis':120 'declar':91 'default':51 'docstr':8,32 'document':11,81 'earn':66 'embed':10 'empti':128 'entri':25 'everi':82 'explicit':58 'face':164 'fail':133 'file':47 'full':54 'full-codebas':53 'generat':169 'histor':119 'idempot':123 'justifi':24 'log':166 'matter':137 'miss':152 'must':149 'name':147 'narrat':122 'no-op':124 'one':157 'op':126 'otherwis':46 'outsid':102 'parti':113 'path':45 'place':68 'primari':80 'prose':12 'provid':42 'quirk':114 'reli':130 'request':60 'requir':57 'resolv':150 'rewrit':20,69 'rule':117 'scope':15 'signal':76 'signatur':87 'sinc':49 'skill' 'skill-audit-comments' 'skip':161 'sourc':100,144 'source-jhostalek' 'spec':109 'stale':34 'string':165 'strip':17,33,61,145,160 'surviv':94 'symbol':148 'target':38,41 'templat':167 'test':135 'third':112 'third-parti':111 'topic-agent-skills' 'topic-ai-coding' 'topic-anthropic' 'topic-claude' 'topic-claude-code' 'topic-claude-code-skills' 'topic-code-review' 'topic-codex-cli' 'topic-cursor' 'topic-developer-tools' 'topic-git-workflow' 'topic-multi-agent' 'torn':159 'trigger':26 'type':77 'use':4 'user':59,163 'user-fac':162 'wrong':156 'x':132","prices":[{"id":"a0c04cab-48cf-4699-a8ce-4c05c253e53d","listingId":"270c8ed3-62bc-4a3c-b3f1-a2f08ae58c88","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"JHostalek","category":"dotclaude","install_from":"skills.sh"},"createdAt":"2026-05-18T13:20:30.113Z"}],"sources":[{"listingId":"270c8ed3-62bc-4a3c-b3f1-a2f08ae58c88","source":"github","sourceId":"JHostalek/dotclaude/audit-comments","sourceUrl":"https://github.com/JHostalek/dotclaude/tree/main/skills/audit-comments","isPrimary":false,"firstSeenAt":"2026-05-18T13:20:30.113Z","lastSeenAt":"2026-05-18T19:13:14.199Z"}],"details":{"listingId":"270c8ed3-62bc-4a3c-b3f1-a2f08ae58c88","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"JHostalek","slug":"audit-comments","github":{"repo":"JHostalek/dotclaude","stars":8,"topics":["agent-skills","ai-coding","anthropic","claude","claude-code","claude-code-skills","code-review","codex-cli","cursor","developer-tools","git-workflow","multi-agent","prompt-engineering","skill-md"],"license":"cc0-1.0","html_url":"https://github.com/JHostalek/dotclaude","pushed_at":"2026-05-17T15:07:41Z","description":"Agent skills for agentic coding tools. Extremely opinionated. Updated (almost) daily.","skill_md_sha":"eed409535c2bfb406d72b992fb7ab0d40844d496","skill_md_path":"skills/audit-comments/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/JHostalek/dotclaude/tree/main/skills/audit-comments"},"layout":"multi","source":"github","category":"dotclaude","frontmatter":{"name":"audit-comments","description":"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\"."},"skills_sh_url":"https://skills.sh/JHostalek/dotclaude/audit-comments"},"updatedAt":"2026-05-18T19:13:14.199Z"}}