Communitygithub.com

Diseño de UI

Carga esta habilidad antes de diseñar, construir o revisar cualquier pantalla o componente de UI, web o móvil: diseño, espaciado, tipografía, color, sombras, botones, formularios, tarjetas, iconos, navegación, imágenes, texto, animación, accesibilidad, estados vacío/de error. Aquí están las reglas que sigue cada pantalla, con un archivo de referencia por tema: lee solo aquellos que tu tarea toque.

¿Qué es Diseño de UI?

Esta habilidad proporciona un conjunto completo de reglas de diseño de interfaces de usuario basadas en el libro *UI Design Principles* de Michael Filipiuk (edición 2021). Está diseñada para guiar a agentes de IA o desarrolladores durante la creación, revisión o modificación de pantallas y componentes de UI tanto web como móviles. Las reglas abarcan desde conceptos generales (como la jerarquía visual y el espaciado) hasta detalles específicos (como el contraste de color, la accesibilidad WCAG, tamaños de botones y animaciones). La habilidad respeta el sistema de diseño existente en el repositorio (temas de Tailwind, variables CSS, librerías como shadcn/MUI) y solo llena los vacíos que ese sistema deje sin definir. Para profundizar en un tema concreto, la habilidad indica qué archivo de referencia leer dentro de la carpeta `references/` —por ejemplo, `tokens.md` para elegir valores iniciales o `buttons.md` para botones. Además, incluye una lista de verificación (`checklist.md`) para revisar el trabajo finalizado. Es ideal para mantener la consistencia visual y funcional a lo largo de un proyecto, asegurando que cada pantalla siga las mismas reglas y evitando conflictos o valores arbitrarios.

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

Preguntar en tu IA favorita

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

Documentación

Diseño de UI: reglas para construir interfaces

Estas reglas están extraídas de UI Design Principles de Michael Filipiuk (edición 2021). Este archivo contiene las reglas que se aplican a cada pantalla. references/ (junto a este archivo) contiene los detalles, un archivo por tema; lee solo los archivos que tu tarea toque.

Las reglas sin etiqueta provienen del libro. (WCAG) marca un estándar de accesibilidad que el libro no menciona. (convention) marca un valor común de la industria añadido para cubrir un vacío. (derived) marca un valor calculado con el método propio del libro. 1 pt en el libro = 1 CSS px = 1 iOS pt = 1 Android dp.

El sistema de diseño del repositorio es el que manda

Si el repositorio ya tiene tokens o un tema (una configuración de Tailwind, variables CSS, un tema de shadcn/MUI, una librería components/ui/), úsalos. Esta habilidad solo llena lo que ellos no definen.

  • Nunca introduzcas un segundo conjunto de tokens junto a los del repositorio.
  • Reutiliza un componente existente en lugar de construir uno paralelo.
  • Cuando el propio repositorio rompa una de las reglas siguientes (un contraste que falla, un botón de 32 px), mantén el valor del repositorio e informa del conflicto. No lo sobrescribas en silencio.

Prioridad cuando las reglas entren en conflicto: usabilidad > accesibilidad > consistencia > simplicidad > aspecto.

Ruta rápida

  1. Personalidad primero: divertida, neutral o seria, según la marca y la audiencia (references/personality-and-copy.md). Nunca tu propio gusto.
  2. Tokens antes que pantallas: colores, escala tipográfica y escala de espaciado, del repositorio o de references/tokens.md. No uses nada fuera de ellos.
  3. Escala de grises primero: consigue jerarquía, disposición y espaciado correctos, luego añade color solo donde tenga un propósito.
  4. Componentes con todos los estados (por defecto, hover, presionado, foco, deshabilitado, error, éxito), y todos los estados de la pantalla (vacío, cargando, error, 404).
  5. Antes de reportar como terminado: repasa references/checklist.md para lo que hayas construido. Si puedes capturarlo en pantalla, revisa la captura, no el código.

Innegociables

  1. El espaciado viene de la escala. Usa una escala de 4 pt en móvil y una escala de 8 pt en web. Nada de valores 5, 13 o 22 px.
  2. El texto del cuerpo es de 16–17 px. Nunca bajes de 10 px para ningún texto, y prefiere 12 px o más. Nunca uses un peso Light en texto pequeño.
  3. Una sola tipografía, una sans serif por defecto. Usa alrededor de 5 tamaños.
  4. Nunca uses #000000 para texto o sombras. Usa un gris oscuro entintado como #1F1F1F.
  5. Un solo color primario, aplicado solo a lo que debe destacar. Si todo destaca, nada destaca.
  6. Contraste: 4.5:1 para texto del cuerpo, y 3:1 para texto grande y partes de la interfaz (WCAG).
  7. Nunca uses solo el color para transmitir significado. Los errores, mensajes de éxito y enlaces también reciben un icono, texto, peso o un subrayado.
  8. Cada objetivo de toque o clic es de al menos 44×44, incluso cuando el glifo visible sea más pequeño.
  9. Los botones miden 40–60 px de alto, con un botón primario por grupo. Cuando los botones vienen en pares, el primario va a la derecha. La etiqueta dice exactamente lo que ocurre.
  10. Los inputs siempre tienen una etiqueta visible. Un placeholder solo no es una etiqueta. Usa un formulario de una sola columna con validación inline, y nunca borres lo que el usuario introdujo.
  11. Las sombras son suaves (desplazamiento Y grande, desenfoque grande, opacidad del 5–10%), y solo en elementos interactivos o elevados.
  12. Los iconos vienen de un mismo pack, con un solo estilo, el mismo grosor de trazo y el mismo redondeo. Los iconos que no sean universalmente conocidos llevan una etiqueta.
  13. Las animaciones dan retroalimentación, duran menos de 1000 ms y tienen easing (nunca lineales).
  14. Nada de Lorem Ipsum. Escribe texto real, breve y humano. Los errores dicen cómo solucionar el problema. Los diálogos nombran el objeto y la consecuencia.
  15. Lo mismo, mismo aspecto, mismo comportamiento en todas las pantallas. Sigue los patrones de la plataforma para el comportamiento.

Qué referencia leer

La tarea tocaLeer
Un proyecto o tema nuevo, elegir valorestokens.md (espaciado, escala tipográfica, roles de color, radio, sombra, movimiento, CSS inicial)
Una página o disposición de pantalla, cuadrícula, espaciado, jerarquíalayout.md
Estilos de texto, encabezados, párrafostypography.md
Paleta, modo oscuro, sombras, degradadoscolor-and-depth.md
Botones y CTAsbuttons.md
Formularios, inputs, selects, checkboxes, validaciónforms.md
Tarjetas, listas de elementoscards.md
Iconosicons.md
Barra de pestañas, navegación superior, barra lateral, enlacesnavigation.md
Fotos, ilustraciones, arte de estado vacío y 404imagery.md
Sensación de marca, etiquetas de botones, diálogos, errores, tonopersonality-and-copy.md
Transiciones, hover, carga, retroalimentaciónmotion.md
Contraste, texto alternativo, objetivos, subtítulosaccessibility.md
Componentes para reutilizar, estados, pantallas vacías/404, un sistema de diseñosystem-and-states.md
Revisar una pantalla terminadachecklist.md

Todas las rutas están bajo la carpeta references/ de esta habilidad.

Skills relacionados