# Web Design Guidelines

> 前端 UI 审查清单：可读性、视觉密度、间距、响应式、空状态、加载态和可访问性。

- Skill: `openbmb/web-design-guidelines` (Agent Skill)
- Install (CLI): `npx skillmds@latest add openbmb/web-design-guidelines`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openbmb/web-design-guidelines/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: OpenBMB (https://skillmd.com/u/openbmb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/openbmb/web-design-guidelines

---


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

## PilotDeck Migration Note

- Source inspiration: Vercel Agent Skills web design guidance and common UI QA practice.
- This is a PilotDeck-native draft, not a verbatim copy.