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
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
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 systematically evaluate UX/UI design candidates across multiple disciplines—UX researchers, UI designers, product designers, design systems engineers, and coordinators—using role-specific competency frameworks. The skill converts vague impressions into defensible scoring systems that account for cross-functional collaboration capability, process maturity, and systems-thinking critical to design ops success. You'll compare candidates across seniority levels, document evaluation decisions for compliance, and build consistent hiring rubrics your entire design team can deploy.
by calesthio
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
This skill guides you through creating strategic content frameworks that go beyond tone and voice guidelines. You'll synthesize user research with business goals, define content principles, structure information architecture, and document messaging frameworks that teams can reference repeatedly. The result is a comprehensive strategy that ensures every piece of UX content—from microcopy to help documentation—serves both users and business outcomes.
by calesthio
You can generate, test, and iterate on onboarding microcopy that handles the unique constraints of first-run experiences: zero product knowledge assumptions, anxiety management around data entry and permissions, and sequential task dependencies. Claude helps you stress-test copy variants against user objections, anticipate drop-off points, and create messaging that balances education, reassurance, and motivation in minimal word count.
by calesthio
You can generate detailed interaction specifications for complex user flows and component behaviors that eliminate ambiguity in handoff. The skill produces structured documentation including state diagrams, transition tables, animation timing, keyboard navigation patterns, error handling workflows, and accessibility requirements—all formatted for both designers and developers to reference.
by calesthio