About polish
A ui-craft sub-skill for implementing a polish pass on an existing UI. It applies a review checklist and checks or strengthens the surface's signature detail according to CRAFT_LEVEL.
Key features
- 01Apply the review polish checklist
- 02Verify or strengthen a signature detail
- 03Gate work by CRAFT_LEVEL
- 04Edit implementation files directly
- 05Report changes and craft findings
Use cases
- 01Refining a UI after its initial build
- 02Checking that a distinctive design detail remains
- 03Applying review fixes before finalization
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/polishin Claude Code to confirm it loaded.
Details
From the project READMEContext: this sub-skill is one lens of the broader ui-craft skill. If the ui-craft skill is also installed, read its SKILL.md first for Discovery + Anti-Slop + Craft Test, then apply the specific lens below.
Polish the UI at $ARGUMENTS. Load the ui-craft skill.
Source of truth: read references/review.md → Polish Pass (Compound Details) section. Apply every item on that list to the target. Do not re-derive the list here — review.md owns it.
Then the signature detail: surfaces built via /craft already carry exactly one signature bet, chosen in the Craft Read and built in the first pass (references/craft-intent.md). Polish verifies it survived and strengthens it — never stacks a second. Only if the surface predates craft-intent (no signature anywhere) do you propose and add one: a subtle motif, an asymmetric layout break, a custom list marker, a distinctive hover — one thing someone would remember.
Knob gating (CRAFT_LEVEL):
≤ 4→ skip the Polish Pass. Ask the user first before running it.5-7→ apply everything on the list, leave the signature as-built unless asked.8+→ apply everything + verify/strengthen the signature detail (add one only if the surface has none).
Output: edit the code directly (polish is implementation, not critique). After each file, print the Review Format table from SKILL.md showing what changed and why. No full diffs — one row per change.
Close every run with a Craft Report (references/review.md → Craft Report). The table above is the per-file diff log; the Craft Report is the run's receipt — Checked / Passed / Changed / Left alone / Verdict. Produce it even when the Polish Pass found nothing to change — that is itself the finding.
Next step: /finalize — the pre-ship gate (rung 3).