AI/UX PLAYGROUND
Subscribe newsletter
PromptVisual design

Design Token Audit

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

Share

Actions

Tags

design-tokensdesign-systemauditconsistencyorganization

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. 1Gather your design tokens: Collect design token documentation, JSON files, or design system token lists
  2. 2Replace [design system/product], [name], and [colors / spacing / typography / etc.] with your specific details
  3. 3Replace [Paste token list or provide access to token documentation] with your actual tokens. Format: "Colors: [list]" "Spacing: [list]" etc.
  4. 4If you have token JSON: Paste your design tokens JSON file. Say "Design tokens JSON: [paste JSON]"
  5. 5If you have Figma tokens: Use Figma MCP to extract tokens first, then paste them here
  6. 6Add 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. 7Paste the modified prompt into your preferred AI tool, like ChatGPT or Claude
  8. 8Review the token audit: Check token inventory, consistency analysis, duplicate identification, and consolidation opportunities
  9. 9Prioritize fixes: Focus on high-priority fixes first (duplicates, inconsistencies), then medium, then low
  10. 10Ask for specifics: Request "Focus on color token consolidation" or "Identify typography token duplicates" or "Detail naming convention issues"
  11. 11Export to your tool: Copy the audit and migration plan to Notion, Confluence, or your design system documentation
  12. 12Use for token cleanup: Apply the migration plan to consolidate and improve your design tokens

Pro 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

Related Prompts

Branding

Logo System Spec Writer

Turn a chosen logo direction into production-ready logo system specs: lockups, spacing, sizing, color, and usage rules.

logo-designbrand-guidelinesdesign-system
Visual design

UI Component Specification

Generate a detailed UI component specification with states, variants, and interaction patterns.

uicomponentsspecification
Visual design

Visual Hierarchy Design

Design effective visual hierarchy for layouts to guide user attention and improve readability.

visual-hierarchygraphic-designlayout
Visual design

Design System Component Visual Spec Writer

Developer-friendly visual specs: anatomy, tokenized properties per variant/state, spacing, responsive behavior, and accessibility for one component cluster.

visual-designdesign-systemcomponents

New prompts & templates by email

Weekly copy-paste prompts, pattern notes, and AI UX resources on Substack - no spam, unsubscribe anytime.

Subscribe on Substack