Communitygithub.com

Design Tokens

Cria o sistema visual de um site como propriedades customizadas CSS, abrangendo paleta de cores, escala tipográfica, espaçamento, cantos arredondados e sombras, com verificação de contraste.

O que é Design Tokens?

Este skill permite que um agente de IA (como Claude Code, Cursor ou Codex) defina um sistema de design completo para um site usando tokens de design (variáveis CSS). Em vez de estilos ad-hoc, ele gera um conjunto coerente de tokens nomeados para cores, tipografia, espaçamento, bordas e sombras, garantindo que o resultado pareça projetado, não montado. O skill orienta o agente a pedir ao usuário uma cor de marca (ou uma palavra de humor), se a base é clara ou escura, e o tom desejado (corporativo, divertido, editorial, técnico). A partir disso, ele deriva os tokens de cor, escala tipográfica fluida com clamp(), espaçamentos consistentes e uma personalidade de cantos arredondados. A saída é um arquivo tokens.css com blocos :root e [data-theme="dark"], além de uma tabela de uso dos tokens. Uma parte crucial é a verificação automática de contraste usando a ferramenta 'webcraft contrast' ou scripts Python, garantindo que todos os pares de texto e fundo atendam aos níveis WCAG (4.5:1 para texto secundário, 7:1 para texto do corpo). O skill também cobre rebranding de sites existentes, mapeando valores hard-coded para tokens primeiro.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/design-tokens

Perguntar na sua IA favorita

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

Documentação

O que Design Tokens faz?

Um pequeno conjunto de valores nomeados, usados em todo lugar, é o que faz um site parecer projetado em vez de montado. Defina tokens antes dos componentes; alterar uma marca depois significa editar um único bloco.

O que perguntar

Uma cor de marca (ou uma palavra de humor), base clara ou escura, e o tom (corporativo, divertido, editorial, técnico). Todo o resto pode ser derivado.

Cor

Trabalhe com papéis, não com nomes de cores, para que uma reformulação da marca não exija renomeação.

TokenPapelRegra prática
--bgFundo da páginaOff-white ou quase preto, nunca #fff ou #000 puros
--surfaceCartões, campos de entrada2 a 4% de diferença de --bg em luminosidade
--textTexto do corpoPelo menos 7:1 sobre --bg
--mutedTexto secundárioPelo menos 4.5:1 sobre --bg
--borderLinhas finas10 a 15% da cor do texto misturada no fundo
--accentBotões, destaquesA cor da marca
--accent-inkLinks e texto de destaque sobre --bgA marca, escurecida (ou clareada no escuro) até passar 4.5:1
--on-accentTexto sobre destaqueA cor (branco ou escuro) que passar 4.5:1

Diretrizes:

  • Tingir os neutros ligeiramente para o matiz do destaque (2 a 6% de saturação). Cinzas puros ao lado de um destaque quente parecem desconexos.
  • Use o destaque em aproximadamente 10% da superfície. Se tudo for destacado, nada é.
  • Raramente é necessário um segundo destaque. Adicione um apenas para um significado distinto, como sucesso ou promoção.
  • Para o modo escuro, não inverta. Aumente a luminosidade da superfície conforme a elevação aumenta e reduza um pouco a saturação do destaque para que ele não brilhe.

Se a CLI webcraft estiver disponível, gere um conjunto inicial em vez de derivar valores manualmente. Ela aplica todas as regras acima, resolve a luminosidade até que cada par passe e constrói o tema escuro separadamente:

webcraft tokens "#e4572e" --tone editorial -o tokens.css      # também: --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json                 # WordPress theme.json com os mesmos valores

Dentro de um cliente MCP, a mesma coisa é a ferramenta generate_tokens. Trate a saída como um primeiro rascunho: ajuste visualmente e depois verifique novamente.

Verifique cada par de texto e fundo antes de finalizar:

webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css   # fallback sem instalação, apenas valores hex

A primeira forma imprime a taxa e os níveis WCAG para um par. A segunda lê um arquivo CSS e verifica os pares de papéis padrão em todos os blocos de tema (:root, [data-theme], prefers-color-scheme), resolvendo var() e lendo hex, rgb(), hsl(), oklch() e color-mix(). Pares que falham são o defeito de acessibilidade mais comum em sites novos e são invisíveis para pessoas com boa visão em um bom monitor; é por isso que isso é um script e não uma questão de julgamento.

Tipografia

  • No máximo duas famílias: uma para títulos, outra para corpo. Uma única família em dois pesos geralmente é melhor.
  • Combine por contraste de estrutura (serifa decorativa com corpo sem serifa, ou condensada decorativa com corpo regular), não duas sem serifas semelhantes.
  • Tamanho do corpo de 16 a 18px, altura de linha de 1.5 a 1.7, comprimento de linha de 60 a 75 caracteres.
  • Tipografia decorativa: altura de linha de 0.95 a 1.1, espaçamento negativo que cresce com o tamanho.
  • Escala fluida com clamp() para que não haja saltos entre pontos de quebra:
:root {
  --step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
  --step-0:  clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
  --step-1:  clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
  --step-2:  clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
  --step-3:  clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
  --step-4:  clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
  --step-5:  clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
  • Carregue fontes com font-display: swap, pré-carregue os um ou dois arquivos usados acima da dobra e subconjunte se estiver hospedando localmente.

Espaçamento, cantos arredondados, sombra

:root {
  --space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
  --space-6: 1.5rem;  --space-8: 2rem;   --space-12: 3rem;   --space-16: 4rem;
  --section: clamp(4rem, 3rem + 6vw, 9rem);   /* preenchimento vertical entre seções */
  --gutter:  clamp(1rem, 0.5rem + 3vw, 3rem); /* preenchimento lateral da página */
  --container: 76rem;

  --radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
  --shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
  • Escolha uma personalidade de canto (afiado, suave ou pílula) e mantenha-a. Cantos misturados são a maneira mais rápida de parecer inconsistente.
  • O espaçamento entre seções deve ser claramente maior do que o espaçamento dentro delas; essa diferença é o que diz ao olho onde uma seção termina.

Saída

Entregue um tokens.css com um bloco :root, um bloco opcional [data-theme="dark"] e uma pequena tabela de qual token é usado onde. Em seguida, declare os resultados de contraste para o texto do corpo, texto secundário e texto do botão.

Reformulando a marca de um site existente

Mapeie primeiro os valores codificados existentes para papéis (pesquise o CSS por códigos hex e conte as ocorrências), substitua-os por tokens, verifique se nada mudou visualmente e, em seguida, troque os valores dos tokens. Fazer ambos ao mesmo tempo torna impossível rastrear regressões.

Individual skills in this repo

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

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

Habilidades Relacionadas