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.