polishlisted
Install: claude install-skill mthines/agent-skills
# Polish — Re-runnable Branch Quality Gate
Get a branch into clean, reviewable shape **before** it goes up for review — and run it again any time you've made a lot of changes and want to tidy up.
This skill is an **orchestrator**. It does not contain quality rules of its own; it composes two existing pieces over the current branch diff:
1. The **`pr-reviewer` agent** — broad review via the branch's open PR (read-only; findings are surfaced for you to act on, applied via `implement-suggestion`). Requires an open PR — `pr-reviewer` has no PR-less mode. If no PR is open, Pass A is skipped and you are told to open a draft PR via `/create-pr` first.
2. The **`code-quality` skill in `simplify` mode** — applies Class M *mechanical* refactors one at a time behind `Skill("confidence", "code") ≥ 90 %` and a scoped fast-check, reverting any that fail. Class J (judgment) recipes stay as proposals.
`/create-pr` delegates its post-draft quality step to `review-loop` (the bounded convergence loop), which calls only `polish simplify` — never full `polish`. You can run `polish` standalone at any point for a pre-draft local check.
## Modes
Parse the **first token** of `$ARGUMENTS`. Everything else is a flag.
| Mode | Trigger | What runs |
| -------------------- | -------------------------------- | ----------------------------------------------------