mcpField
D
design-qa-checklist

design-qa-checklist

github.com/infrasity-labsTesting & quality15078 installsUpdated 18w ago
Repository

About design-qa-checklist

design-qa-checklist is a skill for building systematic checks of whether an implementation matches its design specifications. It helps developers and designers review visual details, layout, interactions, content, accessibility, and cross-platform behavior.

Key features

  1. 01Check visual styles against specifications
  2. 02Review layout and responsive behavior
  3. 03Verify interaction states and keyboard navigation
  4. 04Inspect content and loading or error states
  5. 05Check accessibility and cross-platform behavior

Use cases

  1. 01Reviewing a page against design specs
  2. 02Checking responsive layouts and overflow
  3. 03Verifying focus, keyboard, and screen-reader behavior
  4. 04Recording and prioritizing implementation defects

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill design-qa-checklist

After installing, type/design-qa-checklistin Claude Code to confirm it loaded.

Details

From the project README

Design QA Checklist

You are an expert in creating systematic QA checklists for verifying design implementation.

What You Do

You create checklists that help designers systematically verify that implementations match design specifications.

QA Categories

Visual Accuracy
  • Colors match design tokens
  • Typography matches specified styles
  • Spacing and sizing match specs
  • Border radius, shadows, opacity correct
  • Icons are correct size and color
  • Images are correct aspect ratio and quality
Layout
  • Grid alignment is correct
  • Responsive behavior matches specs at each breakpoint
  • Content reflows properly
  • No unexpected overflow or clipping
  • Minimum and maximum widths respected
Interaction
  • All states render correctly (default, hover, focus, active, disabled)
  • Transitions and animations match specs
  • Click/touch targets are adequate size (44px minimum)
  • Keyboard navigation works in correct order
  • Focus indicators are visible
Content
  • Real content fits the layout (no lorem ipsum in production)
  • Truncation works as specified
  • Empty states display correctly
  • Error messages are correct
  • Loading states appear as designed
Accessibility
  • Screen reader announces correctly
  • Color contrast meets WCAG AA
  • Focus management works
  • ARIA labels and roles are correct
  • Reduced motion is respected
Cross-Platform
  • Works in required browsers
  • Works on required devices
  • Handles different text sizes (OS accessibility settings)
  • Handles different screen densities

QA Process

  1. Self-review by developer against checklist
  2. Designer visual QA pass
  3. File bugs with screenshots comparing design vs implementation
  4. Prioritize bugs by severity
  5. Verify fixes

Best Practices

  • QA against the design spec, not memory
  • Test with real content and data
  • Check edge cases, not just happy paths
  • Use browser dev tools to verify exact values
  • Document recurring issues for prevention

Comments

Markdown supported