token-documentation

What problem does it solve?

This Skill addresses the common issue of design token documentation being incomplete or only detailing resolved values, leading to misuse and system drift. It ensures tokens have clear semantic intent, usage context, and application rules.

Core Features & Use Cases

• Semantic Intent Documentation: Clearly defines what each token communicates to users.
• Usage Guidance: Provides context on where and how tokens should be applied, including do/don't examples.
• Tiered Documentation: Structures documentation for primitive, semantic, and component tokens.
• Theming Contract: Documents how tokens behave across different themes.
• Use Case: Automatically generate comprehensive documentation for a new set of color tokens, explaining their semantic meaning (e.g., color.action.primary signifies a primary interactive element), their resolved values in light and dark themes, and which components use them.

Quick Start

Document the 'color' token set from the provided JSON file.