Frontend Design (visual & UX quality)
Trigger phrases: "visual design", "design system", "make it look good", "UI polish", "page layout", "the layout is", "spacing", "typography"
frontend decides how the code is structured; a11y decides whether everyone can use it; this skill decides
whether it looks considered and feels right. The through-line: a few consistent decisions, applied everywhere,
read as "designed" — many one-off decisions read as "assembled". Design is subtraction and rhythm, not adding flourish.
Crewforth adaptation (local, .claude/): Stack-agnostic. Detect and respect the project's existing design system
(tokens, component library, brand) — never impose a personal aesthetic or a new library. Accessibility is a floor,
not a trade-off: apply a11y alongside (contrast, focus, motion). §4 Prohibitions apply.
The six levers (order = impact; fix hierarchy before you touch color)
- Hierarchy — the eye must land on the one primary thing first. Establish it with size, weight, and space — not with more color. One primary action per view; everything else is visibly secondary.
- Spacing & rhythm — consistent spacing from a single scale (e.g. 4/8px steps). Group related things with less space, separate groups with more. Whitespace is the cheapest way to look premium.
- Typography — one or two families, a small scale (≈4–6 steps), consistent line-height (~1.5 body). Limit weights. Measure ~45–75 chars per line. Type does most of the hierarchy work.
- Color — a restrained system: 1 brand/accent, a neutral ramp, semantic states (success/warn/error). Accent is for action and emphasis, not decoration. Verify contrast (→
a11y).
- Layout & composition — align to a grid; consistent alignment edges. Respect proximity/similarity (Gestalt). Responsive by intent (reflow, not just shrink); design the breakpoints, don't inherit them by accident.
- State & polish — design loading / empty / error / disabled / hover / focus as first-class, not afterthoughts. Motion is restrained and purposeful (~150–250ms, ease), and honors
prefers-reduced-motion.
When the project gives no design direction
Look for the project's own system first: a token file, a theme, the components it already has. If there is one,
follow it; the list below only fills a gap. With none, do not fall into these defaults on your own (use one when
the user asks for it):
- a cream or off-white ground with serif headings and a terracotta accent
- a purple-to-blue gradient hero on white
- a black ground with a single neon accent
- an italic accent word in headings
- "01 / 02 / 03" section numbers that tell no real sequence
- monospace labels on everything
- pill buttons and the same shadow everywhere
- emoji as section markers
- cards with a colored stripe along one edge
"Avoid a generic look" alone swaps one default for another; naming the patterns is what works. After the first
result, look at which default crept in and add it to this list for the project — iterate, don't restart.
Checklist
Tokens, scales, and a heuristic design review
Spacing/type/color scale systems, turning ad-hoc values into tokens, dark-mode and density variants, and a
squint-test / heuristic-review pass to run before handing UI back: references/design-review.md.
Coordination
Architecture, state, and folder structure → frontend. Accessibility gate (contrast, focus, ARIA) → a11y.
Applied by crew-frontend-expert on any stack; the stack-specific "how" stays in the project's frontend skill.
Invariant rules
- Hierarchy before decoration — fix what the eye sees first before adding any color or flourish.
- One scale per dimension — spacing, type, and radius each come from a single defined scale.
- Reuse the project's system — detect existing tokens/components; never impose a new aesthetic or library.
- Accessibility is a floor — contrast, focus, and reduced-motion are non-negotiable, not a style trade-off.
- Every state is designed — loading/empty/error/disabled are part of the design, not defaults.
1---2name: frontend-design-33description: |4 Visual and UX design quality for interfaces: hierarchy, spacing rhythm, typographic scale, a restrained color5 system, layout composition, and polished states. The taste layer above frontend architecture and a11y.6metadata:7 source: https://skillmd.com/skills/byerlikaya/frontend-design-38---910# Frontend Design (visual & UX quality)1112<!-- routing-eval reads the next line; why it sits in the body: AGENT_TEMPLATE.md -->13Trigger phrases: "visual design", "design system", "make it look good", "UI polish", "page layout", "the layout is", "spacing", "typography"1415`frontend` decides how the code is structured; `a11y` decides whether everyone can use it; **this skill decides16whether it looks considered and feels right.** The through-line: **a few consistent decisions, applied everywhere,17read as "designed" — many one-off decisions read as "assembled".** Design is subtraction and rhythm, not adding flourish.1819> **Crewforth adaptation (local, .claude/):** Stack-agnostic. **Detect and respect the project's existing design system**20> (tokens, component library, brand) — never impose a personal aesthetic or a new library. Accessibility is a floor,21> not a trade-off: apply `a11y` alongside (contrast, focus, motion). §4 Prohibitions apply.2223## The six levers (order = impact; fix hierarchy before you touch color)241. **Hierarchy** — the eye must land on the one primary thing first. Establish it with size, weight, and space — not with more color. One primary action per view; everything else is visibly secondary.252. **Spacing & rhythm** — consistent spacing from a single scale (e.g. 4/8px steps). Group related things with *less* space, separate groups with *more*. Whitespace is the cheapest way to look premium.263. **Typography** — one or two families, a small scale (≈4–6 steps), consistent line-height (~1.5 body). Limit weights. Measure ~45–75 chars per line. Type does most of the hierarchy work.274. **Color** — a restrained system: 1 brand/accent, a neutral ramp, semantic states (success/warn/error). Accent is for *action and emphasis*, not decoration. Verify contrast (→ `a11y`).285. **Layout & composition** — align to a grid; consistent alignment edges. Respect proximity/similarity (Gestalt). Responsive by *intent* (reflow, not just shrink); design the breakpoints, don't inherit them by accident.296. **State & polish** — design loading / empty / error / disabled / hover / focus as first-class, not afterthoughts. Motion is restrained and purposeful (~150–250ms, ease), and honors `prefers-reduced-motion`.3031## When the project gives no design direction32Look for the project's own system first: a token file, a theme, the components it already has. If there is one,33follow it; the list below only fills a gap. With none, do not fall into these defaults on your own (use one when34the user asks for it):35- a cream or off-white ground with serif headings and a terracotta accent36- a purple-to-blue gradient hero on white37- a black ground with a single neon accent38- an italic accent word in headings39- "01 / 02 / 03" section numbers that tell no real sequence40- monospace labels on everything41- pill buttons and the same shadow everywhere42- emoji as section markers43- cards with a colored stripe along one edge4445"Avoid a generic look" alone swaps one default for another; naming the patterns is what works. After the first46result, look at which default crept in and add it to this list for the project — iterate, don't restart.4748## Checklist49- [ ] One clear primary action; hierarchy readable at a glance (squint test)50- [ ] All spacing from one scale; related grouped, groups separated51- [ ] Type scale limited and consistent; line length and line-height comfortable52- [ ] Color restrained; accent reserved for action; contrast passes (`a11y`)53- [ ] Aligned to a grid; responsive by intent with designed breakpoints54- [ ] Loading / empty / error / disabled states designed, not default55- [ ] Motion purposeful, reduced-motion honored56- [ ] Existing design tokens/system reused — nothing one-off invented5758---5960## Tokens, scales, and a heuristic design review61Spacing/type/color scale systems, turning ad-hoc values into tokens, dark-mode and density variants, and a62squint-test / heuristic-review pass to run before handing UI back: **`references/design-review.md`**.6364## Coordination65Architecture, state, and folder structure → `frontend`. Accessibility gate (contrast, focus, ARIA) → `a11y`.66Applied by **crew-frontend-expert** on any stack; the stack-specific "how" stays in the project's frontend skill.6768## Invariant rules691. **Hierarchy before decoration** — fix what the eye sees first before adding any color or flourish.702. **One scale per dimension** — spacing, type, and radius each come from a single defined scale.713. **Reuse the project's system** — detect existing tokens/components; never impose a new aesthetic or library.724. **Accessibility is a floor** — contrast, focus, and reduced-motion are non-negotiable, not a style trade-off.735. **Every state is designed** — loading/empty/error/disabled are part of the design, not defaults.