← ClaudeAtlas

dissolve-commentslisted

Enforce self-describing code over a resolved scope (diff, branch, or ranked repository): a three-way comment triage that deletes zero-information comments, dissolves code-expressible comments into names and structure via behavior-preserving refactoring, and keeps only terse, load-bearing comments code cannot express. Deletions and local renames apply behind a token-level proof, other refactors behind a discovered test net, else proposed; 'safe' mode restricts applied edits to removals. Use when: 'dissolve comments', 'remove comments', 'strip agent comments', 'too many comments', 'make it self-documenting', 'make the code expressive', 'comments must earn their keep', after an agent wrote over-commented code. Skip when: read-only residue classification (audit-comment-residue), lane-hunting structural tidyings (tidy), simplification waves (batch-simplify), markdown noise (docs-hygiene audit-noise), adding why-comments (tidy #14). Never touches public-API doc comments, license headers, or machine-read directives.
melodic-software/claude-code-plugins · ★ 15 · API & Backend · score 73
Install: claude install-skill melodic-software/claude-code-plugins
## Repository context. Gather first Collect these with **individual** Bash calls, one command per call, never combined into a single invocation: - Current branch, `git branch --show-current` Treat a failure (not a repository, git unavailable) as an unknown value and carry on. Keep these as separate body Bash calls rather than pre-compute lines: the harness runs a skill's whole pre-compute block as one shell invocation, and a worktree-isolated session refuses a compound command that contains git. ## Pre-computed context Scope (rung, base, count, then a 10-path preview; re-run the script without `--max` for the full set): !`bash "${CLAUDE_PLUGIN_ROOT}/scripts/scope-code-files.sh" --max 10 2>/dev/null || echo "(not a git repository)"` Tooling layer (present/absent per analysis layer; an absent row names the capability lost): !`bash "${CLAUDE_PLUGIN_ROOT}/scripts/comment-tooling-probe.sh" 2>/dev/null || echo "(probe unavailable)"` ## Variables Arguments: `$ARGUMENTS` Posture: `${user_config.comment_posture}` (unexpanded or empty means `strict`; any value outside `strict`, `balanced`, `conservative` is read as `strict`). Kept-comment line budget: `${user_config.class_c_max_lines}` (unexpanded or empty means `2`). Apply proven local renames without a test net: `${user_config.apply_local_renames}` (unexpanded or empty means `true`). ## Purpose The enforcement counterpart to `/code-tidying:audit-comment-residue`: where that skill classifies and reports, this one edits. It m