Docs Design Review

Design Review Pipeline

9 skills. One pipeline. Deterministic quality.

The Pipeline

critique → audit → clarify → hard → polish → typeset → adapt → optimize → delight

9 Skills

1. critique-skill — Design Quality

Heuristic review using Nielsen's 10 usability heuristics and 4 persona tests. Detects AI slop patterns. Produces a score per heuristic.

2. audit-skill — Technical Quality

5-dimension scan: accessibility, performance, theming, responsive, anti-patterns. P0-P3 severity scoring.

3. clarify-skill — UX Copy

Rewrites labels, errors, buttons, empty states, confirmations. Voice-tuned per audience.

4. hard-skill — Accessibility

Mechanical P0/P1 fixes: ARIA attributes, keyboard navigation, form validation, error/empty/loading states.

5. polish-skill — Design Details

Fixes spacing, alignment, token drift, border radius, shadows. No design decisions — only compliance.

6. typeset-skill — Typography

Applies type ramp, fixes line-height, letter-spacing, paragraph rhythm.

7. adapt-skill — Responsive

Breakpoints, touch targets (≥44px), viewport handling, mobile overflow.

8. optimize-skill — Performance

Bundle size, lazy loading, image optimization, animation compositing, layout thrashing.

9. delight-skill — Micro-interactions

Hover/tap feedback, state transitions, loading animation, success/error feedback.