kb-design-tokens

Converts hardcoded UI styles to reusable tokens via Tailwind's @apply.

Updated May 19, 2026
One-click install
npx skills add https://github.com/TimeKast/AgendaInteligente --skill kb-design-tokens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-design-tokens
Source: https://github.com/TimeKast/AgendaInteligente/tree/main/.claude/skills/kb-design-tokens
Command: npx skills add https://github.com/TimeKast/AgendaInteligente --skill kb-design-tokens

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents UI drift and fragile styling by eliminating hardcoded visual values so your design system stays auditable and themeable.

Core Features & Use Cases

  • Portable token system patterns: Defines a two-layer model (primitive vs semantic) so components consume intent-based tokens rather than raw values.
  • Anti-tokens enforcement: Establishes clear rules to reject hex/rgb/px/shadow/radius/typography literals and arbitrary utilities outside the token definitions.
  • Discrete scale discipline: Standardizes radius, spacing, elevation, and typography into tiered scales to keep visuals coherent across the product.

Use case example: During a UI audit, review a feature branch for inline hex colors, pixel paddings, and custom shadow recipes, then remap them to the nearest semantic tokens (or propose missing ones) to ensure the component works across all declared themes.

Quick Start

Ask an AI to audit your component code for hardcoded hex/px/shadows and refactor every styling decision to use semantic design tokens mapped to the nearest primitives, extending the token scale only with explicit, approved proposals.

Frequently Asked Questions about kb-design-tokens

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert hardcoded CSS values into semantic design tokens?

To convert hardcoded CSS values into semantic design tokens, you remap raw hex colors, pixel paddings, and custom shadows to a two-layer primitive-to-semantic pipeline. This ensures components consume intent-based tokens rather than raw values, keeping styling auditable and theme-ready.

What are anti-tokens in UI auditing and component refactoring?

Anti-tokens are enforcement rules that reject raw hex, rgb, px, shadow, radius, and typography literals in application code. During UI auditing, these rules identify arbitrary utilities outside token definitions and flag them for remapping to approved semantic tokens or discrete tiered scales.

How do I audit a feature branch for inline hex colors and pixel paddings?

Auditing a feature branch for inline hex colors and pixel paddings involves scanning component code for hardcoded visual literals. The Skill identifies these raw values and remaps them to the nearest semantic tokens or proposes approved scale extensions to maintain visual consistency.

Does this design token pipeline support theme swapping via CSS variables?

Yes, the design token pipeline supports theme swapping via CSS variables by remapping semantic tokens to different primitive values. This token remapping allows components to switch themes seamlessly without altering the underlying application code or violating anti-token rules.

When should I extend the discrete tiered scale for spacing and typography?

You should extend the discrete tiered scale for spacing and typography only with explicit, approved proposals when existing tokens cannot satisfy a design requirement. This discipline prevents UI drift and ensures visuals remain coherent across the product during component refactors.

Can I use this token system pattern with any CSS framework stack?

Yes, you can use this token system pattern with any stack that uses CSS variables or theme configuration. The two-layer primitive and semantic token model applies universally to design-system authoring, UI audits, and component refactors regardless of the specific framework.