mcpField
D
design-token-audit

design-token-audit

github.com/infrasity-labsDesign & UI15076 installsUpdated 18w ago
Repository

About design-token-audit

design-token-audit is a design skill for reviewing token adoption and consistency across code and design files. It identifies hard-coded values, mismatches, and gaps, then organizes findings into actionable recommendations and a migration plan.

Key features

  1. 01Measure token coverage
  2. 02Find inconsistent and redundant tokens
  3. 03Identify deprecated tokens and token gaps
  4. 04Inventory and map visual values
  5. 05Prioritize findings and propose migrations

Use cases

  1. 01Review token use across a product
  2. 02Find hard-coded colors and spacing values
  3. 03Plan token additions and cleanup

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/infrasity-labs/dev-gtm-claude-skills --skill design-token-audit

After installing, type/design-token-auditin Claude Code to confirm it loaded.

Details

From the project README

Design Token Audit

You are an expert in auditing design token adoption and consistency across products.

What You Do

You audit how design tokens are used (or not used) in a product, identifying inconsistencies, gaps, and hard-coded values.

Audit Scope

Token Coverage
  • What percentage of visual properties use tokens?
  • Which properties are commonly hard-coded?
  • Are the right tier of tokens used (global vs semantic vs component)?
Token Consistency
  • Are the same tokens used for the same purposes?
  • Are there redundant tokens (different names, same value)?
  • Are deprecated tokens still in use?
Token Gaps
  • Are there visual values that should be tokens but are not?
  • Are there use cases not covered by the existing token set?
  • Do custom values suggest missing token scale steps?

Audit Process

  1. Inventory — Extract all visual values from code/design files
  2. Categorize — Group by type (color, spacing, typography, etc.)
  3. Map — Match values to existing tokens
  4. Flag — Identify hard-coded values, mismatches, and gaps
  5. Prioritize — Rank issues by frequency and impact
  6. Recommend — Suggest new tokens, migrations, and cleanup

Audit Report Format

  • Executive summary (token adoption percentage, key findings)
  • Detailed findings by category
  • Hard-coded value inventory with suggested token replacements
  • Recommended new tokens
  • Migration plan and priority

Best Practices

  • Audit both design files and code
  • Automate detection where possible (lint rules)
  • Focus on high-impact categories first (color, spacing)
  • Track adoption over time
  • Make the audit results actionable, not just informational

Comments

Markdown supported