What problem does it solve?
It prevents design-system components from drifting from the shared contract by systematically checking code structure, Storybook conventions, test coverage, visual state completeness, and accessibility requirements before changes ship.
Core Features & Use Cases
- Component contract enforcement: Verifies the required 6-file pattern, file responsibilities, TypeScript/public prop typing rules, CVA placement, named exports, and token usage consistency.
- Storybook and testing quality gates: Confirms JSDoc Storybook conventions, disallows unsupported docs configuration, and ensures tests cover hook logic, DOM behavior, ARIA, interaction/keyboard behavior, and disabled states.
- Visual and accessibility verification: Runs the full visual review protocol (focus/contrast, motion, gradients/transitions, touch target) and ensures reduced motion and accessibility gates are satisfied.
Quick Start
Use the components-auditor skill to review an existing component directory against the component contract, Storybook/test references, and the visual review protocol before submitting a PR.