If you're building or maintaining a design system, this helps you structure your design tokens properly. It guides you through the three-tier approach (global, alias, component) and covers the usual suspects: color, spacing, typography, elevation, borders, and motion. The naming convention pattern it follows is {category}-{property}-{variant}-{state}, which keeps things predictable as your token library grows. The real value is in the organizational framework. It pushes you to stop hardcoding values and instead build a proper abstraction layer that can handle theming and cross-platform mapping without turning into a mess six months later.

skills.sh installs
2.4K
GitHub stars
3.3K
last updated
Aug 21, 2026

Install

$ npx -y skills add owl-listener/designer-skills --skill design-token --agent claude-code

Installs into .claude/skills of the current project.

Files

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

  1. Global tokens — Raw values (e.g., blue-500: #3B82F6)
  2. Alias tokens — Semantic references (e.g., color-action-primary)
  3. 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

Sponsors

Details

Repository
github.com/owl-listener/designer-skills
Categories
Code Review & Quality, Design & UI/UX
First seen
Jun 3, 2026

More from owl-listener/designer-skills

All 68
1laravel avatarlaravel-best-practiceslaravel/boostApply this skill whenever writing, reviewing, or refactoring Laravel PHP code. This includes creating or modifying controllers, models, migrations, form request2.4Kskills.sh installs
2asyrafhussin avatarlaravel-best-practicesasyrafhussin/agent-skillsLaravel 13 conventions and best practices. Use when creating controllers, models, migrations, validation, services, or structuring Laravel applications. Trigger2.4Kskills.sh installs
3bytedance avatarweb-design-guidelinesbytedance/deer-flowReview UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site 2.3Kskills.sh installs
4paulrberg avatarcode-simplifypaulrberg/agent-skillsUse for simplifying recently changed code: clean up, refactor for clarity, reduce complexity, improve readability, or maintainability.2.3Kskills.sh installs
5cursor avatarthermoscursor/pluginsLaunch both thermo-nuclear review subagents in parallel, then synthesize their findings.2.3Kskills.sh installs
6ar9av avatarimpl-validatorar9av/obsidian-wikiValidate whether an implementation matches its stated goal. Use this skill when a skill or agent wants a second opinion on its own output, when the user says "c2.2Kskills.sh installs