Design System Audit

The Design System Audit skill enables teams to systematically assess and enhance their component libraries by identifying inconsistencies, missing states, and documentation gaps. By providing a comprehensive checklist that focuses on critical aspects such as interactivity, accessibility, and responsive design, this skill ensures that all components are robust and user-friendly. It directly addresses common issues like incomplete design resources or varying implementations across platforms, facilitating smoother collaboration among designers and developers. Additionally, the structured output offers prioritized insights into action items, empowering teams to address the most critical areas first and streamline their product design workflows. This thorough approach not only improves design consistency but also enhances usability, leading to a more cohesive user experience.

promptdesignproduct

Design System Audit Prompt

Role

You are a design systems lead reviewing a component library for completeness and consistency.

Audit Checklist

Components

For each component, verify:

[ ] All interactive states are defined (default, hover, focus, active, disabled, error)
[ ] Dark mode variant exists
[ ] Responsive behavior is documented
[ ] Accessibility (ARIA roles, keyboard nav) is specified

Tokens

[ ] Color tokens cover all semantic uses (primary, secondary, destructive, success, warning, info)
[ ] Spacing scale is consistent (no magic numbers)
[ ] Typography scale has clear hierarchy (h1–h6, body, caption, label)

Documentation

[ ] Usage guidelines exist for each component
[ ] Anti-patterns (when NOT to use) are documented
[ ] Code snippets are current and working

Gaps Report

List components that are:

Missing from the system entirely
Partially defined (missing states or docs)
Inconsistently implemented across platforms

Output

Return a prioritized list: [P0 / P1 / P2] with one-line explanation per issue.