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 can write clean, maintainable Tailwind CSS directly in React JSX using utility-first principles. This skill helps you compose responsive layouts, implement dark mode themes, extract reusable component patterns, convert existing CSS to Tailwind, and troubleshoot Tailwind configuration issues. It's optimized for dashboards, forms, cards, modals, and other typical application interfaces.
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
Conduct comprehensive design operations audits using repeatable protocols that quantify inefficiencies across workflows, handoffs, and governance. You'll identify systemic bottlenecks, map dependencies and ownership gaps, and produce actionable recommendations with business cases for process improvements. The framework helps you move from reactive problem-solving to proactive optimization by accounting for team capacity, tool constraints, and organizational context.
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 customized interview frameworks that assess design ops candidates against specific competencies aligned with your team's maturity and challenges. The skill produces behavioral interview questions, technical scenario assessments, and scoring rubrics that help interview panels evaluate candidates objectively across process optimization, metrics thinking, tool knowledge, and organizational influence—moving beyond portfolio review to predict job-ready performance.
by calesthio
You can translate research objectives into executable test protocols that recruit the right participants, ask the right questions, and measure outcomes clearly. This skill helps you design moderated or unmoderated tests that validate interaction patterns, test information architecture, evaluate new features, or compare design alternatives—with structured analysis frameworks built in.
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
Conduct comprehensive culture assessments that go beyond pulse surveys to uncover hidden friction points impacting designer satisfaction and retention. You'll quantify culture health across key dimensions like psychological safety, autonomy, growth opportunity, and collaboration effectiveness, then generate prioritized improvement roadmaps with specific interventions backed by team feedback. This framework helps you build evidence-based business cases for culture investments and track improvements across quarterly cycles.
by calesthio