# Build UI

> New UI should look like it was always part of the product. Extend what exists: the project's

- Skill: `amsborse/build-ui` (Agent Skill)
- Install (CLI): `npx get-skill add amsborse/build-ui`
- Raw SKILL.md: https://api.skillmd.com/api/skills/amsborse/build-ui/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: amsborse (https://skillmd.com/u/amsborse)
- Updated: 2026-11-17
- Page: https://skillmd.com/skills/amsborse/build-ui

---


# Build UI

New UI should look like it was always part of the product. Extend what exists: the project's
components, tokens and CSS approach come first; no new UI library or design language without
a clear need. Never default to 3D, gradients, glass, clay or cinematic: the product decides.
For improving existing screens use `revamp-ui` instead.

Before building a component, interaction or effect, search Arsenal and reuse what fits; register
what you build there (`~/agent-skills/shared/creative/arsenal.md`). Extra selectable designs
follow `~/agent-skills/shared/creative/design-variants.md`.

## Steps

1. **Inspect** the product with `~/agent-skills/shared/creative/adaptation.md`: purpose,
   users, branding, design system, content density, devices, accessibility, performance
   budget, references and framework. Write the 3–5 line direction note it asks for.
2. **Structure first:** content and states (loading, empty, error, success, long text,
   narrow screens) before decoration. Essential actions never depend on hover. Data shows
   only real values; never invent numbers.
3. **Tokens:** reuse the project's spacing, type, color and radius tokens for both themes;
   add tokens there, not inline values.
4. **Implement** with the existing framework and component library. Isolated pages or
   components go to Codex per `~/agent-skills/shared/creative/codex-orchestration.md`; you
   keep direction, review and acceptance.
5. **Enhance only where it earns its place:** interactions via `add-interactions`, motion via
   `build-animation`, visuals via `create-visuals`, 3D via `build-3d`. Each technique comes
   from `~/agent-skills/shared/creative/README.md` (load only the files you use) and its
   technology from `~/agent-skills/shared/creative/selector.md`.
6. **Browser loop:** follow `~/agent-skills/shared/creative/visual-loop.md` (render, capture,
   critique, improve, verify) at desktop, tablet and mobile, light and dark, hover, keyboard
   and reduced motion. Run `audit-design`'s runner on the result; fix every blocker and major.

## Report

Screenshot paths (before, if a page existed, and after), runner pass/fail, what was built and
any decisions left for the owner as numbered options.

