AI UX PlaygroundNewsletterJoin 2K+ AI designers and PMs on Substack. New teardowns, patterns, and prompts as they drop.

Visual design

Design Token Audit

Audit design tokens for consistency, identify duplicates, and recommend consolidation strategies.

Prompt

Audit the design tokens for [design system/product].

Token Context:
- Design system: [name]
- Token types: [colors / spacing / typography / etc.]
- Current token count: [if known]

[Paste token list or provide access to token documentation]

Provide:

1. Token Inventory
   - All tokens by category
   - Token naming patterns
   - Token organization
   - Usage frequency (if available)

2. Consistency Analysis
   - Naming convention compliance
   - Value consistency
   - Usage patterns
   - Inconsistencies identified

3. Duplicate Identification
   - Duplicate values
   - Similar tokens that could merge
   - Redundant tokens
   - Consolidation opportunities

4. Gap Analysis
   - Missing tokens
   - Incomplete token sets
   - Coverage gaps
   - Needed additions

5. Token Organization
   - Current structure assessment
   - Recommended structure
   - Grouping improvements
   - Hierarchy recommendations

6. Naming Convention Review
   - Current naming patterns
   - Naming inconsistencies
   - Recommended naming system
   - Migration strategy

7. Value Optimization
   - Unused tokens
   - Overly specific tokens
   - Value standardization opportunities
   - Scale improvements

8. Migration Plan
   - Tokens to deprecate
   - Tokens to consolidate
   - New tokens to add
   - Migration timeline
   - Breaking changes

9. Documentation Recommendations
   - Token documentation needs
   - Usage guidelines
   - Examples needed
   - Tooling improvements

10. Implementation Priority
    - High priority fixes
    - Medium priority improvements
    - Low priority cleanup
    - Quick wins

Format as a comprehensive token audit with prioritized recommendations.

How to use

  1. 01

    Gather your design tokens: Collect design token documentation, JSON files, or design system token lists

  2. 02

    Replace [design system/product], [name], and [colors / spacing / typography / etc.] with your specific details

  3. 03

    Replace [Paste token list or provide access to token documentation] with your actual tokens. Format: "Colors: [list]" "Spacing: [list]" etc.

  4. 04

    If you have token JSON: Paste your design tokens JSON file. Say "Design tokens JSON: [paste JSON]"

  5. 05

    If you have Figma tokens: Use Figma MCP to extract tokens first, then paste them here

  6. 06

    Add context before the prompt: Describe your design system and token structure. Example: "Design system: Material Design 3. Token types: Colors, spacing, typography, border radius. Current token count: ~150 tokens."

  7. 07

    Paste the modified prompt into your preferred AI tool, like ChatGPT or Claude

  8. 08

    Review the token audit: Check token inventory, consistency analysis, duplicate identification, and consolidation opportunities

  9. 09

    Prioritize fixes: Focus on high-priority fixes first (duplicates, inconsistencies), then medium, then low

  10. 10

    Ask for specifics: Request "Focus on color token consolidation" or "Identify typography token duplicates" or "Detail naming convention issues"

  11. 11

    Export to your tool: Copy the audit and migration plan to Notion, Confluence, or your design system documentation

  12. 12

    Use for token cleanup: Apply the migration plan to consolidate and improve your design tokens

Tips

  • Include token JSON: Paste your actual design tokens JSON so AI can analyze real token values and structure
  • For Figma-based tokens: First use "Extract Design System Using Figma MCP" prompt, then use this audit on the extracted tokens
  • Specify token categories: Mention token types (colors, spacing, typography) so AI audits all categories
  • Request consolidation plan: Ask "Create detailed migration plan for token consolidation" for actionable steps
  • Save as baseline: Use the audit as a baseline and re-run periodically to track token improvements