
Design System Audit & Component Specification Generator
Audit design systems and generate component specs with accessibility reports
What You Can Do
You audit your existing design system against industry best practices, identifying gaps in consistency, coverage, and accessibility. The skill generates detailed component specifications with variants, props, and code examples ready for developer handoff, and produces WCAG 2.1 compliance documentation for every component. You receive a prioritized roadmap for improving system maturity, complete with visual consistency checks and accessibility remediation guidance.
Features
Comprehensive evaluation of your design tokens, components, and patterns against established design system best practices and industry standards
Auto-generates detailed specs for each component including all variants, props with types, usage guidelines, and implementation code examples
Assesses every component against Level AA standards, identifies violations, and provides specific remediation steps with priority ratings
Catalogs all colors, typography scales, spacing systems, and shadows with validation checks for consistency and proper naming conventions
Visualizes relationships between components, identifies composition patterns, and highlights opportunities for reusability and consolidation
Detects deviations in spacing, sizing, color usage, and typography across your component library with flagged inconsistencies
Generates specs in multiple formats (Markdown, JSON, HTML) compatible with Figma, Storybook, design tools, and developer documentation platforms
Prioritized recommendations for system improvements, maturity scoring, and phased rollout guidance for closing identified gaps
Example Output
Button Component Specification
Variants: Primary, Secondary, Tertiary, Destructive, Ghost
Sizes: Small (32px), Medium (40px), Large (48px)
States: Default, Hover, Active, Disabled, Loading
Accessibility Assessment
- ✓ Color contrast: 5.2:1 (WCAG AAA compliant)
- ✓ Keyboard navigation: Full tab and arrow key support
- ✓ Screen reader: Proper ARIA labels and button roles
- ⚠ Touch target size: 36px on mobile (recommend 44px+)
- ✗ Loading state missing aria-busy="true"
Issues & Recommendations
- Inconsistent icon sizing — Icons 16px in Small, 20px in Medium (recommend 16px, 20px, 24px)
- Missing focus indicator — No visible focus ring on keyboard navigation
- Disabled state contrast — 3.1:1 ratio fails WCAG AA (needs 4.5:1)
Implementation Priority
- Critical: Fix disabled state contrast, add aria-busy to loading state
- High: Implement visible focus ring, standardize icon sizing
- Medium: Increase mobile touch target to 44px
What's Included
- Complete Audit Report: Full assessment document covering consistency, coverage gaps, accessibility issues, and overall system maturity score
- Component Specification Templates: Detailed specs for each component including variants, props, accessibility notes, and implementation code examples
- WCAG 2.1 Compliance Checklist: Component-by-component accessibility assessment with violation severity, remediation steps, and compliance status
- Design Token Inventory: Comprehensive catalog of all design tokens with usage frequency, validation status, and consistency checks
- Visual Consistency Analysis: Detailed report of spacing, sizing, color, and typography deviations with visual examples and correction guidance
- Prioritized Implementation Roadmap: Actionable recommendations ranked by impact and effort, with phased rollout suggestions for system improvements
Who It's For
- Design System Leads & Architects
- UX/Product Design Managers
- Design Engineers & Front-End Architects
- Accessibility & QA Specialists
- Engineering Leaders Planning Design System Maturity
Best For
- Auditing existing design systems for gaps and inconsistencies
- Generating component specifications for developer handoff
- Creating accessibility compliance documentation
- Standardizing design tokens across teams and products
- Planning design system modernization and maturity improvements






