comprehensive-design-audit

Orchestrate multi-phase design system audits to identify token, API, accessibility, and documentation gaps.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Expanly/expanly-claude-code-agents --skill comprehensive-design-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comprehensive-design-audit
Source: https://github.com/Expanly/expanly-claude-code-agents/tree/main/plugins/gemini-design-system/skills/comprehensive-design-audit
Command: npx skills add https://github.com/Expanly/expanly-claude-code-agents --skill comprehensive-design-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about comprehensive-design-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a design system for token and accessibility gaps?

To audit a design system for token and accessibility gaps, you can run a multi-phase analysis that scans components, identifies missing patterns, and generates a prioritized remediation backlog with file-level references.

What is the best way to find inconsistent token architecture in a large component library?

Finding inconsistent token architecture in a large component library requires a deep context analysis that reviews token naming conventions across components and outputs a concrete action plan for migration and standardization.

Can I generate an action plan for outdated design system documentation?

Yes, you can generate an action plan for outdated design system documentation by defining audit goals during discovery, running a deep analysis on existing guidelines, and producing a concrete backlog with migration steps.

Does a design system audit work for a component API with 150+ components?

A design system audit works for a component API with 150+ components by systematically scoping the scale, applying deep context analysis to identify API gaps, and delivering actionable recommendations with user checkpoints.

How do I start a design system audit using Gemini?

To start a design system audit using Gemini, initiate a discovery phase to define known issues and success metrics, then proceed through initial scans, clarifying questions, and deep analysis to generate actionable insights.

Why does my design system audit need clarifying questions before analysis?

Your design system audit needs clarifying questions before analysis to accurately scope audit goals, address known issues, and ensure the deep context analysis effectively targets token, API, and accessibility gaps for precise remediation.