design-system-audit

Identify design-system drift with file:line evidence and P0–P3 findings.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/Flintmere/flintmere --skill design-system-audit-flintmere
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-system-audit
Source: https://github.com/Flintmere/flintmere/tree/main/.claude/skills/design-system-audit
Command: npx skills add https://github.com/Flintmere/flintmere --skill design-system-audit-flintmere

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The design-system-audit identifies drift and inconsistencies across Flintmere's design system without making any changes to source files, ensuring canonical alignment.

Core Features & Use Cases

  • Read-only evaluation of tokens, color values, typography, spacing, motion, and accessibility implications to surface drift.
  • Evidence-first reporting with file:line citations and severity levels (P0–P3) to guide handoffs to design or engineering teams.
  • Use cases include quarterly audits, pre-release design reviews, and design-token governance checks.

Quick Start

Run the audit to generate a drift findings report detailing recommended handoffs.

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 design system drift across my repository?▼

Auditing design system drift involves scanning tokens, typography, spacing, and color values across your repository to identify inconsistencies. This read-only evaluation surfaces P0–P3 severity findings with file:line evidence for design and engineering handoffs.

What is design system drift and when should I check for it?▼

Design system drift occurs when token values, components, or styles diverge from canonical definitions. You should check for it during quarterly audits, pre-release design reviews, and design-token governance checks to maintain alignment.

Can I use a design audit to check tokens and components without modifying code?▼

Yes, a read-only design audit evaluates tokens, color values, typography, spacing, and motion across the src/design, tokens, and components areas without modifying source files, ensuring canonical alignment remains intact during the review.

What's the best way to report design system inconsistencies for engineering handoff?▼

The best way to report design system inconsistencies is through evidence-first reporting with file:line citations and P0–P3 severity levels. This approach guides handoffs to design or engineering teams by prioritizing drift findings accurately.

Does the design audit evaluate accessibility implications alongside token drift?▼

Yes, the design audit evaluates accessibility implications alongside tokens, color values, typography, spacing, and motion. It surfaces these findings as P0–P3 severity issues with file:line evidence for comprehensive design-token governance.

What limitations exist when auditing design system drift in source files?▼

The primary limitation is that the audit is strictly read-only and cannot modify code. It applies specifically to the src/design, tokens, and components areas to surface drift findings, requiring separate manual implementation for any recommended fixes.