token-audit

Audits design system token definitions for naming violations and missing semantic tiers.

155|7|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/murphytrueman/design-system-ops --skill token-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: token-audit
Source: https://github.com/murphytrueman/design-system-ops/tree/main/skills/token-audit
Command: npx skills add https://github.com/murphytrueman/design-system-ops --skill token-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill identifies and rectifies issues within design token architecture, ensuring consistency, preventing structural debt, and improving the maintainability of design systems.

Core Features & Use Cases

  • Token Auditing: Analyzes token definitions for naming violations, missing semantic tiers, and structural inconsistencies.
  • Tier Structure Analysis: Assesses the presence and integrity of primitive, semantic, and component token tiers.
  • Automated Reporting: Generates a structured report with severity-rated findings and prioritized remediation guidance.
  • Use Case: A design system lead can use this Skill to audit their existing token set, identify hardcoded values, and receive a prioritized list of tokens to refactor for better semantic meaning and consistency across platforms.

Quick Start

Audit my design tokens and provide a report on their health.

Frequently Asked Questions about token-audit

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

FAQPage Schema
How do I audit design tokens for naming violations and missing semantic tiers?

You can audit design tokens by providing your token definitions to this Skill. It analyzes the architecture for naming violations, missing semantic tiers, and structural debt, then generates a prioritized remediation report with effort estimates.

Can I analyze Figma variables and Style Dictionary tokens for hardcoded values?

Yes, this Skill integrates directly with Style Dictionary and Figma variables to comprehensively analyze token architecture and identify hardcoded values that bypass semantic tiers.

What is structural debt in design token architecture and how do I identify it?

Structural debt in design token architecture consists of inconsistencies and missing tiers across primitive, semantic, and component levels. This Skill identifies structural debt by analyzing token definitions and generating a severity-rated report with remediation guidance.

Does this design token audit work with existing naming conventions?

Yes, the design token audit analyzes your existing token definitions for naming convention violations. It evaluates the integrity of primitive, semantic, and component token tiers to ensure consistency across platforms.

How do I generate a remediation report for inconsistent design tokens?

You can generate a remediation report by running this Skill to audit your inconsistent design tokens. It produces a structured, severity-rated report providing prioritized refactoring guidance and effort estimates to resolve structural debt.

What's the best way to fix missing semantic tokens in my design system?

The best way to fix missing semantic tokens is to audit your token architecture to identify the gaps. This Skill analyzes primitive, semantic, and component tiers, highlighting missing semantic layers and providing prioritized remediation steps.