Communitygithub.com

Sistema de diseño

Úselo al iniciar un sistema de diseño, guía de estilos o conjunto de tokens, agregar o modificar un componente o token, estandarizar pantallas que se han desviado, o auditar una guía en busca de colores sueltos, elementos únicos, estados faltantes o pantallas que no coincidan.

¿Qué es Sistema de diseño?

Este skill guía al agente de IA en la creación, modificación o auditoría de un sistema de diseño, ya sea en Figma, HTML u otras herramientas. Enfatiza la construcción por capas: primero los fundamentos (roles de color, tipografía, espaciado, etc.) y las reglas de interacción, deteniéndose para obtener aprobación antes de avanzar a los componentes. Cada componente debe incluir una matriz de estados completa (variante × estado) y una sección de anatomía. Para auditorías, el agente genera un informe clasificado por severidad sin realizar cambios hasta que el usuario autorice las correcciones. El skill también refuerza reglas firmes como 'cada color es un token' y 'los cambios se propagan solo tras listar las pantallas afectadas', evitando desviaciones comunes como construir múltiples componentes sin aprobación de fundamentos o corregir sin informe previo.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/design-skills/tree/HEAD/skills/design-system

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Sistema de diseño?

Resumen

Un sistema de diseño es el lugar donde una decisión se toma una vez y luego se reutiliza en todas partes. Cada color es un token, cada elemento interactivo muestra todos sus estados y cada cambio llega a todas las pantallas que usan ese elemento. Constrúyelo por capas, primero los fundamentos, y detente para aprobar en cada capa. Una auditoría informa y nunca corrige por sí sola.

Cuándo usarlo

  • "Iniciar una guía de estilos / sistema de diseño / tokens para …"
  • Agregar un componente, variante o token, o modificar uno existente.
  • "Hacer que estas pantallas sean coherentes", "estandarizar", "auditar la guía", o valores hex sueltos y elementos únicos en las pantallas.

Cuándo NO usarlo

  • Una pregunta sobre un valor único ("¿cuál es nuestro color principal?"): respóndela.
  • Una edición pequeña que la persona describió exactamente (un valor, una etiqueta, un tamaño), incluso en un elemento compartido: cámbialo una vez donde está definido y di qué pantallas afecta. Sin matriz de estados, sin parada.

Antes de empezar

  1. Lee DESIGN.md en la raíz del proyecto si existe: es el resumen de diseño del proyecto.
  2. Encuentra lo que existe: tokens, la guía, los componentes, las pantallas y el código. Una guía existente prevalece en el aspecto visual. Sigue sus reglas incluso si difieren de los valores predeterminados a continuación, y menciona la diferencia una vez.
  3. Elige el adaptador de tu herramienta en references/adapters/ (paper.md, figma.md, html.md). Si ningún adaptador coincide con tu herramienta, haz los mismos verbos en tu herramienta y di cuáles mapeaste manualmente. Sin ninguna herramienta de diseño, construye en HTML (html.md). Si solo tienes una imagen, di que los valores leídos de ella son estimaciones.
  4. Decide el modo: crear, agregar o cambiar, o auditar.

Pasos · crear

  1. Borrador de fundamentos:

    • roles de color (roles de token);
    • escala tipográfica;
    • espaciado;
    • radio;
    • sombras (dos como máximo);
    • anchos de diseño;
    • duraciones de movimiento;
    • una sección breve de "cómo escribimos".

    Nombra los tokens por rol (text-muted, border-hover, danger-bg), nunca solo por valor (gray-500).

  2. Reglas de interacción, una vez: para elementos con borde, elementos sin borde y la acción principal, escribe cómo se ven hover, presionado, foco (solo teclado), deshabilitado, carga y seleccionado. Los componentes siguen estas reglas en lugar de inventar las suyas propias.

  3. Detente y muéstrale a la persona los fundamentos y las reglas de interacción. No construyas componentes todavía.

  4. Componentes uno a la vez, en el orden que las primeras pantallas los necesitan. Cada uno obtiene una sección de guía con la anatomía del componente: una leyenda con la regla y el porqué, ejemplos y una matriz de estados de variantes × estados. Agrega cada uno al índice de componentes.

Pasos · agregar o cambiar una pieza

  1. Verifica si un componente existente más una variante cubre la necesidad. Prefiere la reutilización a un elemento único.
  2. Dibújalo con la anatomía, incluida la matriz de estados completa. Un nuevo color, tamaño o ícono se convierte en un token o una entrada del conjunto de íconos ahora, no después.
  3. Enumera cada pantalla y ubicación de código que usa la pieza.
  4. Detente y muéstrale a la persona el cambio y esa lista.
  5. Tras la aprobación, propaga:
    • actualiza cada pantalla de la lista;
    • actualiza el código, si lo hay;
    • actualiza el índice de componentes;
    • informa qué cambió y dónde.

Pasos · auditar

  1. Ejecuta la lista de verificación de auditoría sobre la guía, las pantallas y el código si lo hay.
  2. Redacta el informe: hallazgos clasificados por severidad, cada uno con dónde está, por qué es importante y la corrección propuesta.
  3. Detente y muéstrale a la persona el informe. No cambies ningún archivo hasta que digan qué correcciones hacer. Guardar copias de los originales no hace que editarlos sea aceptable.

Reglas

Firmes (cualquier proyecto):

ReglaPor qué
Cada color es un token; sin valores hex sueltos en pantallas o códigoLos valores sueltos derivan en casi-duplicados que nadie puede cambiar a la vez
Un solo conjunto de íconosLos conjuntos mezclados parecen productos mezclados
El diseño y el código cambian juntos, primero el diseñoDe lo contrario, la guía deja de ser la verdad en una semana
Cada elemento interactivo tiene una matriz de estadosLos estados dibujados ad hoc en las pantallas nunca coinciden
Un cambio en una pieza compartida se enumera con las pantallas que afecta antes de propagarseDe lo contrario, un cambio "pequeño" rediseña silenciosamente veinte pantallas

Valores predeterminados (una guía existente los anula):

Valor predeterminadoPor qué
Al pasar el ratón, los elementos con borde solo oscurecen el bordeUn fondo cambiante en tarjetas y campos se siente pesado
El hover es más sutil que el seleccionadoCuando el hover parece seleccionado, la gente piensa que dos cosas están elegidas
Seleccionar nunca cambia el peso de la fuenteUn cambio de peso desplaza el ancho del texto
Los placeholders son más claros que el texto atenuadoDe lo contrario, un placeholder se lee como texto ingresado
Los elementos en listas apiladas y menús tienen un pequeño espacio, nunca se tocanLos toques de resaltado se fusionan en un solo bloque
El anillo de foco solo aparece desde el tecladoUn anillo después de un clic del ratón parece un error
La carga mantiene el tamaño exacto del elementoCambio de diseño
Sombras solo en elementos flotantes (menús, popovers, diálogos, toasts), con dos intensidadesSombras en todas partes aplastan la jerarquía que debían crear
Como máximo una acción principal por pantallaDos acciones principales significa que la pantalla no decidió

Hecho cuando

  • Crear: fundamentos y reglas de interacción aprobados; cada componente tiene su anatomía, matriz de estados y una fila en el índice.
  • Cambiar: cada pantalla y ubicación de código listada actualizada, y el índice actualizado.
  • Auditar: un informe clasificado entregado y ningún archivo modificado.

Errores comunes

PensamientoRealidad
"Construiré toda la guía de una vez: tokens y diez componentes"Diez componentes sobre fundamentos no aprobados significa diez reelaboraciones. Fundamentos, parada, luego componentes.
"La auditoría encontró problemas, los corregiré directamente"La persona puede estar en desacuerdo con la mitad de las correcciones. Informa, detente, corrige solo lo que elijan.
"Guardé los originales en una carpeta de respaldo, así que corregir es seguro"Un respaldo no hace que la persona acepte las correcciones. Informa primero.
"Los botones tienen hover y deshabilitado, es suficiente"Una matriz de estados tiene cada estado × cada variante: normal, hover, presionado, foco, deshabilitado, carga, seleccionado.
"--teal-600 es un token"Es un valor. Los componentes necesitan roles (--color-primary) para que el valor pueda cambiar en un solo lugar.
"Esta pantalla necesita una tarjeta ligeramente diferente"Conviértelo en una variante de la tarjeta, o usa la tarjeta. Un elemento único es el comienzo de la desviación.

Skills relacionados