Skip to content
Development
Command

/polish

Final craft pass applying the compound details from the polish checklist — micro-typography, spacing rhythm, hover states, and a signature detail — directly to code. Use when the surface is functionally complete but feels unfinished, or when the user says "polish this" / "it

From plugin
ui-craft
45925 skills2 agents25 commands1 hook
+1
> /plugin marketplace add educlopez/ui-craft
> /plugin install ui-craft@ui-craft

Command definition

polish.md
description: Final craft pass applying the compound details from the polish checklist — micro-typography, spacing rhythm, hover states, and a signature detail — directly to code. Use when the surface is functionally complete but feels unfinished, or when the user says "polish this" / "it looks generic" / "add the final touches".
argument-hint: "[file or component path]"

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).

Read more
@educlopez
Ships withui-craft

Ship designer-grade UI by default. A design engineering system for AI coding agents — install it as a skill or as the ui-craft CLI, and your agent starts designing like it has taste. Ask for a dashboard, get one you'd put in production.

45930 skills2 agents1 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
459
Star history of educlopez/ui-craft on GitHub, a chart by star-history.com

Other commands on ui-craft.

adapt

adapt

Command

Responsive layout pass covering breakpoints, touch targets, safe areas, and fluid type. Use when the UI has layout or touch…

@educlopez@educlopezInstall Command
animate

animate

Command

Motion design pass — adds purposeful animations or removes excessive ones, respecting MOTION_INTENSITY and the project's…

@educlopez@educlopezInstall Command
audit

audit

Command

Technical UI audit — a11y, performance, responsive. Produces a prioritized findings table.

@educlopez@educlopezInstall Command
bolder

bolder

Command

Amplify personality — raises layout variance and motion, strengthens typography and one signature detail, without slop. Use when…

@educlopez@educlopezInstall Command
brief

brief

Command

Write or update the project's durable design brief at .ui-craft/brief.md.

@educlopez@educlopezInstall Command
clarify

clarify

Command

UX copy review across buttons, errors, empty states, and form hints — critiques by default, applies only on request. Use when…

@educlopez@educlopezInstall Command

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command