Design System Audit & Gap Analysis
Audit design systems for consistency gaps and generate data-backed improvement roadmaps
What You Can Do
You can systematically evaluate your design system's health using structured frameworks that assess component consistency, design token usage, documentation completeness, and developer adoption. The skill generates prioritized gap analysis reports that quantify issues—like duplicate components, token sprawl, or implementation friction—and translates findings into executive-ready roadmaps with business cases for remediation. You'll move beyond subjective design assessments to data-backed improvement strategies.
Features
catalog all components across Figma and codebase, identify redundant or near-duplicate patterns
audit token naming conventions, usage patterns, and orphaned tokens; flag tokens defined but unused
compare design system spec vs. actual product usage; identify components shipped but not adopted by teams
evaluate coverage, accuracy, and accessibility of design system docs; identify missing guidance
evaluate system architecture for multi-product/platform support; flag structural limitations
convert audit findings into phased improvement plan with effort estimates and ROI justification
generate exec summaries and team-specific reports explaining audit results and business impact
pinpoint where developers abandon the system; suggest UX/process improvements to increase compliance
Example Output
Audit Finding: Component Duplication
- Button component exists in 3 versions (ButtonPrimary, Button_Filled, CTAButton) across 2 product codebases
- Estimated dev time waste: ~12 hours/quarter maintaining variants
- Recommendation: Consolidate to single Button with variant prop system
- Priority: High | Effort: 2 weeks | ROI: 15% velocity recovery
Token Health Report
- 287 color tokens defined, 203 actively used (71% utilization)
- 84 orphaned tokens creating maintenance burden
- Token naming inconsistent (some camelCase, some kebab-case)
- Remediation: Archive unused tokens, standardize naming, implement token linting
Developer Adoption Gap
- 65% of shipped components use design system
- Custom Button implementations found in 3 product teams
- Root cause: DS Button missing specific accessibility feature needed by payment module
- Action: Extend DS Button component, deprecate custom implementations
What's Included
- SKILL.md instruction file: complete audit workflow and framework definitions
- Design System Audit Checklist: comprehensive evaluation criteria across components, tokens, docs, and adoption
- Gap Analysis Template: structured format for documenting inconsistencies with severity ratings
- Remediation Roadmap Framework: prioritization matrix for converting findings into phased improvement plan
- Stakeholder Report Templates: exec summary, team-specific reports, and business case language
Who It's For
- Design system leads — conducting regular health checks and planning refactoring initiatives
- Design ops managers — measuring design system ROI and communicating value to leadership
- Senior product designers — inheriting or scaling design systems across multiple products
- Engineering managers — understanding implementation friction and adoption barriers
- Product managers — prioritizing design system investment against feature development
Best For
- Auditing mature or legacy design systems for hidden technical debt
- Quantifying design system ROI and building business cases for investment
- Identifying component duplication and token inconsistency across codebases
- Assessing developer adoption gaps and barriers to design system usage
- Planning design system refactors with prioritized, phased roadmaps
You might also like
Analyze raw usability testing data—transcripts, session notes, task completion rates, and participant feedback—to surface recurring patterns and user behaviors. Claude identifies the highest-impact issues, extracts testable insights about user mental models, and generates prioritized recommendations ranked by severity, frequency, and business impact. This cuts manual synthesis time from hours to minutes while maintaining analytical rigor.
by calesthio
You can conduct comprehensive microcopy audits across your entire product, categorizing copy by type and user journey stage. Claude helps you identify clarity gaps, consistency issues, and conversion blockers, then generates tested alternatives with clear rationale. You'll produce copy guidelines, A/B test frameworks, and localization-ready copy that drives measurable improvements in user completion rates and confidence.
by calesthio
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.
by az9713
This skill helps you craft error messages and notifications that prioritize clarity and actionability over cleverness. You'll generate empathetic microcopy for error states, in-app notifications, empty states, and edge cases—then test variations against different user personas to minimize cognitive load and maximize task completion rates. It bridges UX research insights with production-ready copy that reduces support tickets and builds user trust.
by calesthio
You can systematically design reusable responsive grid systems, establish spacing scales and breakpoint strategies, and document component layout behaviors for seamless developer handoff. This skill generates technical layout specifications that reduce design-to-development friction and ensure accessibility compliance from the design phase, enabling teams to build consistent, scalable web interfaces across all devices.
by calesthio
You can rapidly build responsive, production-ready UI designs using Tailwind's utility-first approach. Apply low-level utility classes directly to HTML elements to create custom designs without writing CSS, implement mobile-first responsive layouts, add dark mode and theme customization, and generate optimized CSS bundles through build-time processing that includes only the classes you actually use.
by calesthio
You can generate production-ready web interfaces, dashboards, forms, and navigation structures grounded in actual design system best practices. This skill provides access to 60+ documented UI component patterns sourced from industry standards, ensuring your designs follow modern conventions for restraint, typography hierarchy, color strategy, and spacing. Every interface Claude generates will feel polished and professional—not templated.
You'll conduct structured culture audits that go beyond surface-level observations to identify root causes of dysfunction in design teams. Using organizational psychology research, you can analyze team feedback patterns, map collaboration barriers across disciplines, and design targeted interventions that address psychological safety gaps, siloed workflows, and retention risks. Claude helps you transform culture diagnostics into measurable improvement plans tied to specific team performance outcomes.
by calesthio