
Ui Component Architect
Design production-grade UI components with atomic design and accessibility
What You Can Do
Design production-ready UI components that serve as foundations for scalable design systems. You define clear component APIs, TypeScript/JSDoc prop interfaces, comprehensive variant systems (states, sizes, themes, interactions), and full accessibility markup including ARIA labels and semantic HTML. Claude generates complete Storybook stories and documentation to enable seamless developer handoff and cross-team component consumption.
Features
organizes components into atoms, molecules, organisms, templates, and pages with clear hierarchies
creates well-structured specifications with clear contracts and prop documentation
generates comprehensive state, size, theme, and interaction variants with prop combinations
includes ARIA labels, semantic HTML, keyboard navigation, and compliance guidance
produces fully typed prop definitions with inline documentation for developer experience
generates stories demonstrating all component variants and usage patterns
identifies theming and styling points for consistent design system application
captures component behavior under various states, errors, and interactions
Example Output
Button Component Specification
interface ButtonProps {
variant: 'primary' | 'secondary' | 'ghost';
size: 'sm' | 'md' | 'lg';
disabled?: boolean;
loading?: boolean;
icon?: ReactNode;
ariaLabel: string;
}
Storybook Story Example
Default Primary Button → renders with proper contrast ratios
Disabled State → shows disabled cursor, reduced opacity
Loading State → displays spinner, prevents interaction
With Icon + Text → maintains proper spacing and alignment
Accessibility Markup
role="button"for semantic meaningaria-pressedfor toggle statesaria-disabledfor disabled states- Keyboard navigation: Enter/Space activation
What's Included
- SKILL.md instruction file with atomic design methodology:
- Component specification template for defining APIs and props:
- Accessibility checklist covering ARIA, semantic HTML, and keyboard navigation:
- Variant matrix worksheet for mapping component states and combinations:
- Storybook story template with CSF (Component Story Format) examples:
- Design token integration guide for theming and styling points:
Who It's For
- Design System Architects — building foundational component libraries and design systems
- Senior Frontend Engineers — designing scalable component APIs for multi-team consumption
- Product Design Leads — establishing component specifications before development handoff
- Component Library Maintainers — documenting and versioning reusable UI elements
- Accessibility Engineers — ensuring components meet WCAG compliance from design phase
Best For
- Designing atomic design foundations (buttons, inputs, cards, navigation)
- Creating prop interfaces and component API contracts before implementation
- Generating comprehensive variant systems across states, sizes, and themes
- Building accessibility-compliant components with ARIA and semantic markup
- Producing Storybook documentation for developer onboarding and component discovery







