Communitygithub.com

plugin87/design-tokens

Gere, estenda ou audite tokens de design no formato DTCG com a arquitetura de 3 camadas (primitivo → semântico → componente). Use quando o usuário quiser uma paleta de cores, escala tipográfica, tokens de espaçamento/sombra/raio/movimento, temas multi-marca, ou validar arquivos de tokens. Abrange cores, tipografia, espaçamento, sombras, bordas, breakpoints, movimento, gradientes, opacidade, desfoque, dimensionamento, estados, temas.

O que é design-tokens?

Esta skill capacita agentes de IA a gerar, estender ou auditar tokens de design no padrão DTCG (`$type`/`$value`), adotando a arquitetura de três camadas: primitivo → semântico → componente. É extremamente útil para designers e desenvolvedores que precisam manter um sistema de design escalável e acessível, especialmente ao trabalhar com paletas de cores, tipografia, espaçamento, sombras e temas multi-marca. A skill é suportada em qualquer plataforma de agente de IA (como Claude Code, Cursor ou Codex) que possa executar comandos de terminal e ler arquivos de regras. Ela funciona seguindo três etapas principais: primeiro, lê as regras do projeto em arquivos específicos; depois, gera ou estende os tokens conforme a arquitetura definida (primitivos jamais usados diretamente, semânticos como aliases de propósito e componentes com escopo específico); por fim, valida os tokens gerados executando scripts de contraste de acessibilidade e validação JSON. Dessa forma, garante que os tokens estejam corretos, acessíveis e prontos para uso em produção.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill: Tokens de Design

Produza e mantenha tokens DTCG ($type/$value) seguindo o sistema de 3 camadas do projeto.

Etapas

  1. Leia .claude/rules/tokens-and-color.md → "Sistema de Tokens" + "Diretrizes de Cores" e .claude/rules/typography-and-spacing.md para as regras (base de 4px, escala Major Third, geração de paleta OKLCH, modo escuro na camada semântica).
  2. Leia os arquivos existentes relevantes em tokens/ para corresponder à estrutura: 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. Gere/estenda tokens:
    • Primitivos = valores brutos (nunca usados diretamente). Semânticos = aliases de propósito. Componente = escopo de componente.
    • Novas paletas: gere 11 matizes OKLCH; verifique 500 ≥ 4,5:1 no branco (texto), 600 ≥ 3:1 (UI) usando a skill a11y-audit / scripts/contrast.py.
    • Multi-marca/densidade → theming.json.
  4. Valide: execute python3 scripts/validate_tokens.py (validade JSON + resolução de alias).

Saída

DTCG JSON. Preserve $description em cada token. Referencie, nunca codifique diretamente.

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.

Habilidades Relacionadas