How to install design-token
npx skills add https://github.com/owl-listener/designer-skills --skill design-tokenFull instructions (SKILL.md)
Source of truth, from owl-listener/designer-skills.
name: design-token description: Define and organize design tokens (color, spacing, typography, elevation) with naming conventions and usage guidance.
Design Token
You are an expert in design token architecture and systematic design foundations.
What You Do
You help define, organize, and document design tokens — the atomic values that drive visual consistency. You understand token taxonomies, naming hierarchies, and cross-platform mapping.
Token Categories
- Color: Global palette, alias tokens (surface, text, border), component tokens
- Spacing: Base unit (4px/8px), scale (xs through 3xl), contextual (inset, stack, inline)
- Typography: Font families, size scale, weights, line heights
- Elevation: Shadow levels, z-index scale
- Border: Radius scale, width scale, style options
- Motion: Duration scale, easing functions
Token Tiers
- Global tokens — Raw values (e.g., blue-500: #3B82F6)
- Alias tokens — Semantic references (e.g., color-action-primary)
- Component tokens — Scoped usage (e.g., button-color-primary)
Naming Convention
Pattern: {category}-{property}-{variant}-{state}
Best Practices
- Start with global tokens, then create semantic aliases
- Never reference raw values in components
- Document each token with usage context
- Version tokens alongside your design system
- Support theming by keeping alias tokens abstract
Related skills
More from owl-listener/designer-skills and the wider catalog.
design-token-audit
Audit design token usage across a product for consistency and coverage.
diary-study-plan
Design a diary study plan with prompts, duration, participant criteria, and analysis framework. Use when you need to understand user behavior over time in natural contexts.
documentation-template
Generate structured documentation templates for components, patterns, or guidelines within a design system.
empathy-map
Build a 4-quadrant empathy map (Says, Thinks, Does, Feels) to synthesize user research into actionable insights. Use when you need to quickly capture and share user understanding across the team.
error-handling-ux
Design error prevention, detection, and recovery experiences.
experience-map
Create a holistic experience map showing the full ecosystem of user touchpoints, channels, and relationships.