Frontend Design Direction

Use this skill when the work is not just making UI function, but making it feel purposeful, polished, and appropriate to the product domain.

Source: salvaged from stale community PR #1659 by linus707.

Note: ecc intentionally does not rebundle the canonical OpenAI frontend-design skill. Install that from openais/skills when you want the official upstream skill. This skill is the ecc-specific design-direction salvage of the useful local guidance from #1659.

When to Use

• The user asks to build a web page, app, dashboard, artifact, component, or UI.
• The user asks to make an interface more polished, distinctive, beautiful, or

less generic.

• The implementation needs visual hierarchy, typography, color, motion, layout,

and interaction choices.

• The current UI works but reads as flat, generic, templated, or mismatched to

the audience.

Design Direction

Before coding, choose a specific direction:

1. Purpose: what job does the interface do?
2. Audience: who repeats this workflow, and what do they need to scan first?
3. Tone: utilitarian, editorial, playful, industrial, refined, technical,

maximal, minimal, dense, calm, or another explicit direction.

1. Memorable detail: one design idea that makes the result feel intentional.
2. Constraints: framework, accessibility, performance, responsiveness, and

existing design system.

Match the direction to the domain. A SaaS operations tool should usually be dense, quiet, and scannable. A portfolio, launch page, game, or editorial piece can be more expressive. Do not force a landing-page composition onto a tool that needs repeated daily use.

Implementation Guidance

• Build the actual usable experience as the first screen unless the user

explicitly asks for marketing copy.

• Use existing project components, tokens, icon libraries, and routing patterns

before introducing a new visual system.

• Use real or generated visual assets when the interface depends on images,

products, places, people, gameplay, charts, or inspectable media.

• Prefer contextual typography and spacing over generic oversized hero text.
• Keep palettes multi-dimensional: avoid a UI dominated by one hue family.
• Use CSS variables or existing design tokens so the direction remains

coherent across states.

• Design responsive constraints explicitly: grids, aspect ratios, min/max

sizes, stable toolbars, and fixed-format controls should not shift when labels or hover states appear.

• Use motion sparingly but deliberately. Prefer high-signal transitions that

clarify state over decorative animation.

• Verify text fit on mobile and desktop. Long labels must wrap or resize

cleanly rather than overflowing.

Anti-Patterns

• Do not default to common generated patterns: purple gradients, decorative

blobs, oversized cards, vague hero copy, or stock-like atmospheric media.

• Do not add UI cards inside other cards.
• Do not use a single decorative style everywhere when the domain calls for

restraint.

• Do not hide the primary product, tool, object, or workflow behind generic

marketing sections.

• Do not add a new dependency for a design flourish unless it clearly pays for

itself.

• Do not describe the UI's features inside the UI when the controls can speak

for themselves.

Review Checklist

• The first viewport immediately communicates the product, workflow, or object.
• The visual hierarchy supports scanning and repeated use.
• Typography fits the container and does not overlap adjacent content.
• Color choices have contrast and do not collapse into a one-note palette.
• Icons are used for familiar tool actions where available.
• Responsive layout has stable dimensions for boards, grids, toolbars,

controls, tiles, and counters.

• Assets render and carry the subject matter instead of acting as filler.
• Motion improves orientation and does not mask sluggishness.
• The result matches the repo's existing frontend conventions unless there is a

clear reason to depart.