UI Tokens

UI Tokens

Overview

Part of StyleSeed, this skill manages design tokens without letting the source-of-truth files drift apart. It is meant for teams using the Toss seed's JSON token files and CSS implementation together.

When to Use

• Use when you need to inspect the current token set
• Use when you want to add a new color, shadow, radius, spacing, or typography token
• Use when you need to update a token and propagate the change safely
• Use when the project has both JSON token files and CSS variables that must stay aligned

How It Works

Supported Actions

• list: show the current tokens in a human-readable form
• add: introduce a new token and wire it through the implementation
• update: change an existing token value and audit the downstream usage

Typical Source-of-Truth Split

For the Toss seed:

• JSON under tokens/
• CSS variables and theme wiring under css/theme.css
• typography support in the font and base CSS files

Rules

• keep JSON and CSS in sync
• prefer semantic names over descriptive names
• provide dark-mode support where relevant
• update the token implementation, not just the source manifest
• check for direct component usage that might now be stale

Output

Return:

1. The requested token inventory or change summary
2. Every file touched
3. Any affected components or utilities that should be reviewed
4. Follow-up actions if the new token requires broader adoption

Best Practices

• Add semantic intent, not one-off brand shades
• Avoid token sprawl by extending existing scales first
• Keep naming consistent with the rest of the system
• Review contrast and accessibility when introducing new colors

Additional Resources

• StyleSeed repository
• Source skill

Limitations

• Use this skill only when the task clearly matches the scope described above.
• Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
• Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Core Process

1. Identify the need for a new token and ensure an existing semantic token doesn't already fit.
2. Update the master JSON token source.
3. Generate or manually update the corresponding CSS variables.
4. Explicitly define and verify the corresponding dark-mode token values.

Common Rationalizations

Red Flags

• CSS variables and JSON token sources are out of sync.
• Missing dark mode definitions for new color tokens.
• Creating highly specific, non-reusable tokens instead of semantic ones.

Verification

• Token is defined in both the JSON source and CSS variables.
• Dark mode values are explicitly set and verified.
• Token naming follows the established semantic conventions.