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