comprehensive-design-audit

What problem does it solve?

Teams building and maintaining design systems struggle with invisible gaps across tokens, component APIs, accessibility, and documentation. This Skill provides a structured, multi-phase audit to reveal these issues and deliver a prioritized remediation plan using Gemini's deep context.

Core Features & Use Cases

• Discovery & scoping: define audit goals, known issues, and success metrics.
• Phase-based analysis: discovery, initial scan, clarifying questions, deep analysis, and actionable recommendations.
• Action planning: generates a concrete backlog with file-level references and migration steps for token, API, and accessibility improvements.
• Use Case: a design system with 150+ components and tokens can systematically identify inconsistent token naming, missing accessibility patterns, and outdated documentation, then produce an implementation plan.

Quick Start

Start by running a Gemini-based audit across your design system to generate Phase 4 insights, then follow Phase 5 recommendations and Phase 6 action planning to implement changes.