review-and-fix-design-system

Audit Figma screens for design-system drift and fix one validated finding.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design-system drift across Figma screens and components can obscure consistency and slow delivery. This Skill helps teams identify concrete drift findings and document evidence for prioritization so fixes stay scoped and actionable.

Core Features & Use Cases

  • Orchestrates two workflows: audit-design-system for read-only review and fix-design-system-finding for a single narrow repair, enabling end-to-end drift management without broader rewrites.
  • Supports common start points such as a Figma URL, with a strict guideline to choose exactly one high-signal finding for the fix.
  • Enforces guardrails to keep repairs narrow, validated, and tied to library-backed or token-bound targets, preventing scope creep. Use cases include starting from a Figma link and addressing the top issue, or receiving a known finding and applying a focused fix.

Quick Start

Audit a Figma screen for the highest-signal design-system drift and fix one approved issue using the two orchestration workflows.

Frequently Asked Questions about review-and-fix-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 Figma design-system drift, initiate a read-only review of a specific Figma screen or component URL to identify concrete inconsistencies and document evidence for prioritization.

What is design-system drift and how do I identify it in Figma components?

Design-system drift occurs when Figma screens or components deviate from established library or token standards, obscuring consistency and slowing delivery. You identify it by running a focused audit to find concrete inconsistencies.

Can I fix multiple design-system findings on a Figma component at once?

No, you must choose exactly one high-signal finding for a single narrow repair. The workflow enforces guardrails to keep fixes validated and tied to library-backed targets, preventing scope creep during broader rewrites.

What's the best way to repair design-system drift without causing broader rewrites?

The best way to repair design-system drift is applying a focused, single-finding fix workflow that validates the chosen repair against library-backed or token-bound targets before applying the write.

Do I need a Figma URL to start a design-system audit?

Yes, a Figma URL is a common starting point to trigger the audit-design-system workflow, which then identifies the highest-signal drift issue on that specific screen or component for prioritization.

Why should I document evidence when reviewing design-system drift?

Documenting evidence during a design-system drift audit ensures that identified findings are prioritized effectively and that subsequent repairs remain narrowly scoped, actionable, and validated before application.