Communitygithub.com

plugin87/design-tokens

Generar, extender o auditar tokens de diseño en formato DTCG con la arquitectura de 3 niveles (primitivo → semántico → componente).

¿Qué es design-tokens?

Esta skill permite gestionar tokens de diseño siguiendo el estándar DTCG (`$type`/`$value`) y una arquitectura de tres niveles: primitivo, semántico y componente. Es útil para desarrolladores y diseñadores que trabajan con sistemas de diseño, ya que automatiza la creación, extensión y validación de paletas de color, escalas tipográficas, espaciados, sombras, bordes, puntos de ruptura, motion, gradientes, opacidad, desenfoque, tamaños, estados y temas multi-marca. La skill se basa en las reglas del proyecto (base de 4px, escala Mayor Tercera, generación de paletas OKLCH y modo oscuro a nivel semántico) y lee los archivos existentes en `tokens/` para mantener coherencia estructural. Además, incluye validación automática mediante un script de Python que verifica la corrección del JSON y la resolución de alias, y puede auditar el contraste de accesibilidad (relación de contraste 4.5:1 para texto y 3:1 para UI) utilizando habilidades auxiliares. Está diseñada para plataformas como Claude Code, Cursor o Codex, y su documentación completa se encuentra en el archivo SKILL.md correspondiente.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/plugin87/ux-ui-agent-skills/tree/main/.claude/skills/design-tokens

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Skill: Design Tokens

Producir y mantener tokens DTCG ($type/$value) siguiendo el sistema de 3 niveles del proyecto.

Pasos

  1. Leer .claude/rules/tokens-and-color.md → "Token System" + "Color Guidelines" y .claude/rules/typography-and-spacing.md para las reglas (base de 4px, escala Mayor Tercera, generación de paletas OKLCH, modo oscuro a nivel semántico).
  2. Leer los archivos existentes relevantes en tokens/ para coincidir con la estructura: colors.json, typography.json, spacing.json, shadows.json, borders.json, breakpoints.json, motion.json, gradients.json, opacity.json, blur.json, sizing.json, states.json, theming.json.
  3. Generar/extender tokens:
    • Primitivos = valores brutos (nunca usados directamente). Semánticos = alias de propósito. Componente = ámbito de componente.
    • Nuevas paletas: generar 11 tonos OKLCH; verificar que 500 ≥ 4.5:1 sobre blanco (texto), 600 ≥ 3:1 (UI) usando la skill a11y-audit / scripts/contrast.py.
    • Multi-marca/densidad → theming.json.
  4. Validar: ejecutar python3 scripts/validate_tokens.py (validez JSON + resolución de alias).

Salida

JSON DTCG. Mantener $description en cada token. Referenciar, nunca hardcodear.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

plugin87/governance

Govern how the design system evolves — SemVer for tokens/components, the contribution workflow, deprecation policy, and change communication. Use when the user wants to add/promote/deprecate a component or token, decide a version bump, set up a contribution process, or keep the system from fragmenting.

plugin87/image-to-code

Turn a reference image, screenshot, or mockup into token-driven, accessible code — infer the design system from the reference (palette, type scale, spacing, radius, layout archetype), map it to the 3-tier tokens, rebuild it, then verify with the kit's gates. Use when the user provides a design/screenshot and wants matching UI code.

plugin87/performance

Optimize UI performance against Core Web Vitals — LCP, INP, CLS — with loading/code-split strategy, layout-shift prevention, and animation performance rules. Use when the user wants to improve speed, fix jank or layout shift, hit Web Vitals budgets, or make a UI feel fast on low-end devices.

plugin87/prototype

Move an idea up the fidelity ladder (content-first → wireframe → low-fi → high-fi → code) with a validation plan at each level, plus user-journey mapping and usability-testing scripts. Use when the user wants to prototype, wireframe, map a user flow, or plan/run usability testing.

plugin87/redesign

Upgrade an existing website or app to premium quality without breaking functionality — audit the current design, identify generic/AI tells, then apply taste and system rules surgically. Use when the user wants to improve, modernize, polish, or "make better" an existing UI/codebase.

plugin87/token-build

Set up or run the token build pipeline — transform the DTCG tokens/*.json (source of truth) into platform artifacts (CSS variables, Tailwind @theme, JS/TS, iOS Asset Catalog, Android, Compose) with Style Dictionary / Tokens Studio / W3C DTCG export. Use when the user wants to generate platform theme files from tokens, wire token CI, or multi-platform token output.

plugin87/ux-writing

Write or review UI copy — buttons, errors, empty states, microcopy, notifications, labels — using the voice & tone system (clear, concise, useful, human, honest) with the what→why→how error formula and inclusive-language rules. Use when the user needs interface copy, error messages, empty-state text, or a copy review.

Skills relacionados