Communitygithub.com

design-tokens

Crea el sistema visual de un sitio web como propiedades personalizadas CSS, cubriendo paleta de colores, escala tipográfica, espaciado, radios y sombras, con verificación de contraste.

¿Qué es design-tokens?

Esta skill define cómo construir un sistema de diseño coherente utilizando tokens de diseño expresados como propiedades personalizadas CSS. En lugar de depender de valores ad-hoc, establece un conjunto pequeño y nombrado de valores (colores, tipografía, espaciado, radios y sombras) que se utilizan de manera consistente en todo el sitio. La skill automatiza la creación de paletas de color basadas en roles (fondo, superficie, texto, acento, etc.) en lugar de nombres de color, lo que facilita el cambio de marca. También genera escalas tipográficas fluidas con `clamp()`, espaciado uniforme y sombras. Una característica clave es la verificación de contraste incorporada: la skill utiliza el CLI `webcraft` para verificar que todos los pares de texto y fondo cumplan con los estándares WCAG AA (4.5:1) y AAA (7:1). Esto soluciona el problema de que las fallas de contraste son el defecto de accesibilidad más común en sitios nuevos, pero invisible para usuarios con buena visión. Soporta modo oscuro, manejo de fuentes, y rebranding de sitios existentes mapeando primero los valores antiguos a roles. Funciona con el CLI `webcraft`, como herramienta MCP `generate_tokens`, y scripts Python como respaldo.

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

Preguntar en tu IA favorita

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

Documentación

Tokens de diseño

Un conjunto pequeño de valores con nombre, usado en todas partes, es lo que hace que un sitio luzca diseñado en lugar de ensamblado. Define los tokens antes que los componentes; cambiar una marca más adelante se reduce a editar un bloque.

Qué preguntar

Un color de marca (o una palabra de estado de ánimo), base clara u oscura, y el tono (corporativo, divertido, editorial, técnico). Todo lo demás se puede derivar.

Color

Trabaja con roles, no con nombres de color, de modo que un cambio de marca no requiera renombrar.

TokenRolRegla general
--bgFondo de páginaBlanco roto o casi negro, nunca #fff o #000 puros
--surfaceTarjetas, entradas2 a 4% de diferencia en luminosidad respecto a --bg
--textTexto del cuerpoAl menos 7:1 sobre --bg
--mutedTexto secundarioAl menos 4.5:1 sobre --bg
--borderLíneas finas10 a 15% del color del texto mezclado con el fondo
--accentBotones, destacadosEl color de marca
--accent-inkEnlaces y texto de acento sobre --bgLa marca, oscurecida (o aclarada en modo oscuro) hasta que pase 4.5:1
--on-accentTexto sobre acentoEl blanco o el oscuro que pase 4.5:1

Pautas:

  • Tiñe los neutros ligeramente hacia el tono del acento (2 a 6% de saturación). Los grises puros junto a un acento cálido se ven desconectados.
  • Usa el acento en aproximadamente el 10% de la superficie. Si todo está acentuado, nada lo está.
  • Rara vez se necesita un segundo acento. Agrega uno solo para un significado distinto como éxito o oferta.
  • Para modo oscuro, no inviertas. Aumenta la luminosidad de la superficie a medida que aumenta la elevación y reduce ligeramente la saturación del acento para que no brille.

Si el CLI webcraft está disponible, genera un conjunto inicial en lugar de derivar valores manualmente. Aplica todas las reglas anteriores, resuelve la luminosidad hasta que cada par pase, y construye el tema oscuro por separado:

webcraft tokens "#e4572e" --tone editorial -o tokens.css      # también: --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json                 # theme.json de WordPress con los mismos valores

Dentro de un cliente MCP, lo mismo es la herramienta generate_tokens. Trata la salida como un primer borrador: ajusta a ojo, luego vuelve a verificar.

Verifica cada par de texto y fondo antes de finalizar:

webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css   # fallback sin instalación, solo valores hex

La primera forma imprime la relación y los niveles WCAG para un par. La segunda lee un archivo CSS y verifica los pares de roles estándar en cada bloque de tema (:root, [data-theme], prefers-color-scheme), resolviendo var() y leyendo hex, rgb(), hsl(), oklch() y color-mix(). Los pares que fallan son el defecto de accesibilidad más común en sitios nuevos, y son invisibles para personas con buena visión en un buen monitor, por lo que esto es un script y no una decisión subjetiva.

Tipografía

  • Máximo dos familias: una para títulos, otra para cuerpo. Una sola familia en dos pesos suele ser mejor.
  • Combínalas por contraste de estructura (serif display con sans cuerpo, o condensado display con cuerpo regular), no dos sans-serif similares.
  • Tamaño de cuerpo de 16 a 18px, altura de línea de 1.5 a 1.7, longitud de línea de 60 a 75 caracteres.
  • Tipografía display: altura de línea de 0.95 a 1.1, tracking negativo que crece con el tamaño.
  • Escala fluida con clamp() para que no haya saltos entre puntos de interrupción:
: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);
}
  • Carga fuentes con font-display: swap, precarga los uno o dos archivos usados above the fold, y subconjunta si auto-alojas.

Espaciado, radio, 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);   /* padding vertical entre secciones */
  --gutter:  clamp(1rem, 0.5rem + 3vw, 3rem); /* padding lateral de la 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);
}
  • Elige una personalidad de esquina (afilada, suave o píldora) y mantenla. Los radios mixtos son la forma más rápida de parecer inconsistente.
  • El espaciado entre secciones debe ser claramente mayor que el espaciado dentro de ellas; ese espacio es lo que le dice al ojo dónde termina una sección.

Salida

Entrega un tokens.css con un bloque :root, un bloque opcional [data-theme="dark"], y una tabla breve de qué token se usa dónde. Luego indica los resultados de contraste para el texto del cuerpo, el texto atenuado y el texto de los botones.

Rebranding de un sitio existente

Primero mapea los valores codificados existentes a roles (busca en el CSS códigos hex y cuenta las ocurrencias), reemplázalos con tokens, verifica que nada haya cambiado visualmente, luego intercambia los valores de los tokens. Hacer ambas cosas a la vez hace que las regresiones sean imposibles de rastrear.

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.

Skills relacionados