# Web Design Guidelines

> Web Design Guidelines is an Agent Skill for design published in the OpenBMB/PilotDeck repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

- Skill name: `web-design-guidelines`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/OpenBMB/PilotDeck/blob/HEAD/skills/web-design-guidelines/SKILL.md
- Repository: OpenBMB/PilotDeck (3,820 GitHub stars when collected)

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

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

---

Source: https://www.openparable.com/skill/design/web-design-guidelines (OpenParable). Cite the canonical URL above.
