web-design-guidelines

Installation
SKILL.md

Web Design Guidelines

Use this skill after building or modifying web UI. It helps the agent review whether the interface is usable, readable, responsive, and polished.

Checklist

  1. Layout: consistent alignment, predictable grid, no accidental crowding.
  2. Typography: readable sizes, clear hierarchy, line length under control.
  3. Color: sufficient contrast, semantic states, no random palette mixing.
  4. Interaction: clear hover/focus/active/disabled states.
  5. Responsiveness: mobile, tablet, and desktop layouts remain usable.
  6. Accessibility: keyboard focus, labels, alt text, contrast, reduced motion where relevant.
  7. Product states: loading, empty, error, offline, and success states exist when needed.
  8. Polish: spacing, borders, shadows, icon sizes, and copy tone feel consistent.

Output

When reviewing, return: pass/fail summary, top issues, concrete fixes, and files/components likely affected.

Installs
12
GitHub Stars
4.0K
First Seen
Jun 18, 2026
web-design-guidelines — openbmb/pilotdeck