audit-design-system

Audit Figma screens and components for design system drift and token misbindings.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/mayzhangmin/ucd-figma-skills-playground --skill audit-design-system-mayzhangmin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-design-system
Source: https://github.com/mayzhangmin/ucd-figma-skills-playground/tree/main/skills/audit-design-system
Command: npx skills add https://github.com/mayzhangmin/ucd-figma-skills-playground --skill audit-design-system-mayzhangmin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit Figma screens and components to verify alignment with a design system, uncover drift, missing shared primitives, or local overrides that hinder consistency and theming.

Core Features & Use Cases

  • Automatic drift detection: Identify where designs diverge from the design system tokens and primitives.
  • Evidence-based findings: Flag structural issues in Figma (instances vs frames, token bindings, duplicated patterns).
  • Guided remediation cues: Suggest candidate replacements from the audited library and route to appropriate downstream skills.
  • Use Case: For a component library migration, audit screens to surface drift and drive a scope-defined remediation pass.

Quick Start

Provide a Figma node URL or fileKey/nodeId to begin the audit and generate a report.

Frequently Asked Questions about audit-design-system

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

FAQPage Schema
How do I audit a Figma screen for design system drift?

To audit a Figma screen for design system drift, provide a Figma node URL or fileKey/nodeId to identify token misbindings, local overrides, and missing shared primitives. The audit examines structural evidence and presents actionable replacement suggestions.

What is design system drift in Figma components?

Design system drift in Figma components occurs when designs diverge from established tokens and primitives through local overrides, token misbindings, or unbound tokens. This hindrance affects consistency and theming across an application.

Can I flag missing shared primitives in a Figma board?

Yes, you can flag missing shared primitives in a Figma board by auditing individual screens, components, or boards. The audit locates instances of unbound tokens and duplicated patterns to surface missing primitives.

How do I identify token misbindings in Figma?

To identify token misbindings in Figma, audit the target screen or component to examine structural evidence like instances versus frames. The audit flags token misbindings and local overrides, providing actionable replacement suggestions.

What's the best way to review a Figma component library for migration?

The best way to review a Figma component library for migration is to audit screens to surface drift and drive a scope-defined remediation pass. This identifies divergences from the design system and flags missing shared primitives.

Does the audit provide replacement suggestions for local overrides?

Yes, the audit provides replacement suggestions for local overrides. It examines structural evidence in Figma to present guided remediation cues, suggesting candidate replacements from the audited library and routing to downstream skills.