design-system-audit

Audit design systems to identify inconsistencies and undocumented design tokens.

1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/tuantiensiu/todo-app --skill design-system-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-system-audit
Source: https://github.com/tuantiensiu/todo-app/tree/main/.opencode/skill/design-system-audit
Command: npx skills add https://github.com/tuantiensiu/todo-app --skill design-system-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits existing design systems to ensure consistency, document undocumented tokens, and identify design debt, enabling teams to align implementation with design specs and plan refactors.

Core Features & Use Cases

  • Visual inventory: generate a complete token palette and spacing/typography system.
  • Consistency analysis: compare token usage against design specs and flag discrepancies.
  • Design token documentation: capture primitive, semantic, and token structure with recommended changes.
  • Audit reporting: produce structured outputs and actionable recommendations for stakeholders.

Quick Start

Run a full design-system audit on your project to generate a token inventory and an actionable report.

Frequently Asked Questions about design-system-audit

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

FAQPage Schema
How do I audit a design system for token consistency?

To audit a design system for token consistency, you generate a complete token palette and compare token usage against design specs to flag discrepancies. This process produces a structured inventory and actionable audit reports for stakeholders.

What is design debt and how do I identify it during a refactor?

Design debt consists of undocumented design tokens and inconsistencies between implementation and design specs. You identify it by performing a visual inventory of your spacing and typography systems, then comparing actual token usage against your documented specifications.

How do I document undocumented design tokens across multiple products?

You document undocumented design tokens by capturing primitive, semantic, and token structures across multiple products and teams. This workflow enforces a structured token model and outputs comprehensive documentation with recommended changes to align implementation.

Can I use a design system audit for refactor planning across teams?

Yes, you can use a design system audit for refactor planning across teams. It produces structured outputs and actionable recommendations that identify inconsistencies and design debt, enabling teams to align implementation with design specs and plan refactors.

What is the best way to generate a visual inventory of spacing and typography tokens?

The best way to generate a visual inventory of spacing and typography tokens is running a full design-system audit. This workflow enforces a structured token model to extract a complete token palette and compare it against design specs for discrepancies.

Why does my design system have inconsistencies between specs and implementation?

Design system inconsistencies between specs and implementation occur due to accumulated design debt and undocumented tokens. A structured audit compares token usage against design specs, flags discrepancies, and provides actionable recommendations to resolve them.