collapse-pass

Declare the scope (packages or apps), a stop condition such as three consecutive no-finding files or a checkpoint budget, and a starting target. The skill then iterates: count callers with ripgrep, mentally inline candidates, surface each finding, and commit only changes that shrink surface, files, or call depth.

Grep for exported symbols with ripgrep, then cross-reference each name across the repo; a symbol whose only hit is its own definition is a dead-export candidate. Verify it is not in a package's exports map or consumed by external CLI/SDK users before deleting.

Yes. The skill isolates the PR or branch in a git worktree, computes scope with git diff against the base, and runs the same per-iteration ritual on changed files first. It does not stage, commit, or push unless explicitly asked.

Keep one-caller boundaries when they isolate a lifecycle, an unsafe boundary, a public contract, or a long imperative phase. Also pause before changing durable strings, merging packages, or altering signatures that cross a published package boundary.

The anti-cosmetic gate requires every commit to shrink the public API surface, file count, or call-graph depth, or measurably ease a future first read. If none of those is true after a commit, the change is reverted and a deeper smell is sought.