Communitygithub.com

ui-craft

Diseña y construye interfaces premium, profesionales y fáciles de usar para cualquier software: aplicaciones web, paneles, aplicaciones de escritorio (Mac, Windows, Electron), aplicaciones móviles y tabletas (iOS, Android, Flutter, React Native) y sitios de marketing. Cubre dirección de arte (16 direcciones visuales listas), teoría y psicología del color, psicología humana y emoción en UX, detalles artesanales premium, convenciones de plataforma, accesibilidad, prototipos rápidos para clientes y puntuación de un producto existente.

¿Qué es ui-craft?

ui-craft es una habilidad de agente de IA especializada en el diseño y la construcción de interfaces de usuario premium y profesionales para cualquier plataforma. Proporciona un flujo de trabajo completo desde la comprensión del usuario y la selección de una dirección visual (con 16 direcciones predefinidas) hasta la construcción de la interfaz, pasando por la definición de sistemas de tokens, tipografía, color, profundidad y componentes. La habilidad enfatiza la importancia de decisiones coherentes, detalles artesanales, y un diseño honesto que genere confianza, evitando patrones oscuros. Está diseñada para ser utilizada en múltiples plataformas (web, escritorio, móvil) y se integra con herramientas como el ui-craft Studio para la generación de temas y scripts para auditorías de UI. Su enfoque principal es ayudar al agente a crear interfaces que no solo sean correctas, sino que se sientan premium, modernas y únicas, basándose en principios de psicología humana y emoción para guiar las decisiones de diseño.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/najeebafridi/ui-craft/tree/HEAD/skills/ui-craft

Preguntar en tu IA favorita

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

Documentación

¿Qué hace ui-craft?

Cómo construir interfaces que se vean premium y sean fáciles de usar, en cualquier plataforma. Los números están en px CSS; para aplicaciones nativas lee px como pt (iOS, macOS), dp (Android) o epx (Windows).

Premium significa cuatro cosas. Apropiado: se ajusta a la audiencia, su estado de ánimo y la plataforma. Decidido: un sistema pequeño (pocos tamaños, una familia de radios, un acento) aplicado en todas partes. Artesanal: los detalles están terminados. Honesto: genera confianza y nunca engaña. Una pantalla que solo es correcta se ve genérica; una pantalla que solo está decorada se ve barata.

1. Flujo de trabajo (haz esto cada vez)

  1. Mira antes de construir. Verifica si existe un sistema de diseño: tokens, archivo de tema, configuración de Tailwind, biblioteca de componentes, colores de marca, fuentes o un resumen DESIGN.md y theme.css exportados desde ui-craft Studio. Si existe uno, úsalo; no inventes un segundo. Solo llena los vacíos.
  2. Entiende a la persona. ¿Quién usa esto, en qué estado de ánimo (apurado, ansioso, escéptico, experto en flujo) y qué debería sentir? Una línea. Consulta references/psychology-emotion.md.
  3. Elige una dirección. Sin una identidad definida, elige una dirección visual de references/directions.md que se ajuste a la audiencia (no por novedad), lee el encabezado de su archivo en assets/directions/ y anota su firma. Con un color de marca, mantén la dirección y reconstruye los colores: node <skill-dir>/scripts/palette.mjs --accent "#HEX". Las personas que prefieren elegir visualmente pueden usar ui-craft Studio (https://najeebafridi.github.io/ui-craft/): elige una dirección, ajústala en pantallas en vivo y exporta theme.css y un resumen DESIGN.md para que lo sigas.
  4. Escribe el resumen de diseño antes del código (en tu respuesta o un comentario):
    Producto: nómina para pequeñas empresas (aplicación web, escritorio primero)
    Usuario y sentimiento: dueño haciendo nómina por la noche, ansioso por errores -> seguro, guiado, exacto
    Dirección: Ledger de confianza; acento verde azulado profundo (su marca), neutros fríos, tema claro
    Tipo: IBM Plex Sans + Mono, cuerpo 14px, números tabulares      Forma y profundidad: radio 6px, sombras suaves
    Densidad y movimiento: compacto, nítido (120-200ms)              Plataforma: web responsive
    Firma: números dispuestos como un libro mayor; las confirmaciones indican la cantidad y hora exactas
    Tarea principal en esta pantalla: revisar la ejecución de este mes y aprobarla
    
  5. Construye la estructura primero, luego el estilo. Diseño y jerarquía con contenido real, luego el sistema (tokens), luego el detalle. Sin lorem ipsum: escribe nombres, números y textos realistas. Construye la firma temprano y mantén todo lo demás más callado que ella. Muéstralo funcionando. La primera vista es la pantalla en uso: datos reales, valores predeterminados sensatos ya seleccionados, la interacción principal visible. Nunca abras en un estado completamente vacío o bloqueado, un total muerto de "$0" o un paso clave oculto hasta que se haya realizado uno anterior.
  6. Diseña cada estado: carga, vacío, error, éxito, texto largo, muchos elementos, un elemento, sin permiso (references/feedback-states.md).
  7. Termina y verifica. Realiza el pase final en references/premium-craft.md. Luego mira el resultado: con Node y Chrome disponibles, ejecuta node <skill-dir>/scripts/ui-audit.mjs page.html. Evalúa contraste, tamaños, objetivos táctiles y desbordamiento a 1440px y 390px, anota problemas de artesanía y guarda capturas de pantalla. Abre ambas capturas y juzga la del teléfono con la misma rigurosidad que la del escritorio: nada recortado, cubierto o comprimido, el contenido clave en la primera pantalla. Verifica que la pantalla cuente una historia: el resumen coincida con la selección, los totales sumen, los recuentos coincidan con las listas, las fechas concuerden. Corrige lo que veas, luego elimina todo lo que no ayude a la tarea principal. Lista de verificación: references/review-checklist.md.

Prototipos rápidos para un cliente: references/mockups.md. Revisar o puntuar un producto existente: references/review-mode.md.

Capas sobre el mismo tema. Para escenas 3D, shaders, narración con scroll o movimiento cinematográfico, usa la habilidad immersive-web (mismo plugin): lee estos mismos tokens y el nivel --immersive del tema (0 quieto a 3 historia) indica hasta dónde llegar. Para tomar prestado el aspecto de otro género o medio (juego, ciencia ficción, cine), lee references/mixing.md.

2. Densidad por tipo de producto

ProductoTexto del cuerpoDensidadNavegación
Herramienta de datos, administración, herramienta de desarrollo, finanzas14pxcompacta: filas 36px, controles 32-36pxbarra lateral izquierda 220-280px
Aplicación web SaaS14-16pxestándar: controles 36-40pxbarra lateral o barra superior
Panel, analíticas14pxcompactabarra lateral + barra de filtros
Marketing, página de aterrizaje16-18pxespaciosa: secciones separadas 64-96pxbarra superior, 4-6 enlaces + 1 acción
Aplicación móvil16-17pxtáctil: objetivos de 44px o másbarra de pestañas inferior, 3-5 elementos
Aplicación de escritorio13-14px (predeterminado de la plataforma)compactabarra lateral + barra de herramientas; sigue el SO
Consumo, divertido16pxestándarsegún la plataforma

El texto del cuerpo por defecto es 16px; 14px solo en herramientas de escritorio densas. Nunca por debajo de 12px. La densidad compacta es solo para ratón y teclado: en pantallas táctiles, cada control crece a 44px (§13).

3. Jerarquía (la mayor ventaja)

  • Un héroe y una acción principal por pantalla. La acción principal es el único botón de acento sólido; los demás son botones de contorno, sutiles o de texto.
  • Construye jerarquía con tamaño, peso y color juntos. Para que el título destaque, silencia las etiquetas y el meta texto en lugar de agrandar el título.
  • Las etiquetas son más silenciosas que los valores. En "Ingresos $48,210", la etiqueta es de 12-14px atenuada y el valor de 24px seminegrita.
  • Agrupa por espaciado primero, luego matiz de fondo, luego una línea, por último una sombra. La separación entre grupos es al menos el doble de la separación dentro de ellos. Menos cajas y líneas se ven más caras.
  • El orden de lectura coincide con la importancia: la tarea principal está en la parte superior izquierda (en idiomas de izquierda a derecha) o en el centro.

4. Diseño y espaciado

  • Escala de espaciado (base 4px): 4, 8, 12, 16, 24, 32, 48, 64, 96. Solo estas.
  • Dentro de un componente 4-12; entre componentes 16-24; entre secciones 32-48 (aplicaciones), 64-96 (marketing).
  • Relleno lateral de la página: 16px móvil, 24px tableta, 32px o más escritorio. Ancho máximo de contenido 1200-1440px (aplicaciones), 1120-1280px (marketing); texto de lectura 65-75 caracteres.
  • Diseña con cuadrícula o flex y gap. Alinea en ambos ejes: los vecinos comparten bordes izquierdos y líneas de base. Los casi aciertos se ven amateur.
  • El relleno exterior es al menos la separación interior. Cuando tengas dudas, añade espacio en blanco y elimina un borde.
  • Sin espacio muerto. No estires una tarjeta para que coincida con un vecino más alto (align-items: start) y no dejes un panel mayormente vacío: dale contenido real, encógelo o elimínalo.
  • La densidad es una decisión: espaciosa o compacta, siempre exacta. Puntos de interrupción 640, 1024, 1440; verifica 375 y 1440 como mínimo.

Detalles: references/layout-spacing.md.

5. Tipografía

  • Escala tipográfica: 12, 14, 16, 18, 20, 24, 30, 36, 48, 60 (más grande solo para display). 4-6 tamaños por pantalla de aplicación, hasta 7 en una página de marketing.
  • Las fuentes provienen de la dirección o la marca: una familia para aplicaciones, dos como máximo (una cara display para encabezados más una cara de texto neutra). Nunca una fuente porque es la predeterminada. Todas las fuentes sugeridas son gratuitas (SIL OFL).
  • Ajusta el tipo para su tamaño. Altura de línea 1.5 para el cuerpo, 1.2-1.3 para encabezados, 1.05-1.15 para display. Espaciado entre letras: 0 a 14-16px, aproximadamente -0.015em a 20-24px, -0.025em a 30-36px, -0.03 a -0.04em a 48px y más; +0.06em en etiquetas pequeñas en mayúsculas.
  • Pesos: 400 cuerpo, 500 etiquetas y botones, 600 encabezados; 700+ solo para display grande. Como máximo 3 por pantalla. El peso nunca cambia al pasar el ratón.
  • text-wrap: balance en encabezados, pretty en párrafos. font-variant-numeric: tabular-nums en cada número que cambie o se alinee; números alineados a la derecha en tablas.
  • Mayúscula inicial para encabezados, botones y etiquetas. Comillas, guiones y puntos suspensivos reales.

Detalles: references/typography.md.

6. Color

  • Elige el sentimiento primero. La luminosidad y la saturación cambian cómo se siente una pantalla más que el tono: más claro es más agradable, más saturado es más emocionante, baja saturación con fuerte contraste es tranquilo y serio. Luego elige el tono por significado, ajuste de categoría y diferencia de los competidores. references/color-theory.md.
  • Una paleta son neutros matizados + un acento + colores de estado (éxito, advertencia, peligro, información). Los neutros llevan un rastro de color (cálido, frío o el tono de la marca), nunca gris muerto; sin negro o blanco puro para áreas grandes.
  • Mayormente neutro. El acento cubre aproximadamente el 5-10%: botón principal, enlaces, selección, foco, datos clave. Alta saturación solo en puntos pequeños y valiosos.
  • Constrúyelo con scripts/palette.mjs (OKLCH, claro + oscuro, cada texto y color de borde resuelto para pasar el contraste) o tómalo de una dirección. Nunca inventes valores hex a ojo.
  • Solo tokens semánticos en componentes: --bg, --surface, --surface-2, --border, --border-strong, --text, --text-muted, --text-subtle, --accent, --accent-fg, --accent-soft, --accent-text, --focus, --danger… Cada superficie tiene su compañero de primer plano.
  • Piso de contraste (WCAG 2.2 AA): 4.5:1 para texto, 3:1 para texto grande (24px+, o 18.66px+ negrita) y para partes de la interfaz de usuario (bordes de entrada, iconos, anillos de enfoque, marcas de gráficos). Los divisores pueden ser tenues; los bordes de entrada usan --border-strong.
  • Nunca color solo para significado: añade un icono, texto o forma. Los colores de estado se mantienen separados del color de la marca; un rojo de marca nunca duplica el color de error.
  • El modo oscuro es su propia paleta: superficies matizadas casi negras, superficies elevadas más claras, texto casi blanco, acento más calmado. Ofrece ambos temas y sigue el SO.

Detalles: references/color-theory.md, references/color-dark-mode.md. Tokens: assets/tokens.css, assets/directions/.

7. Luz, profundidad y forma

  • Una fuente de luz, desde arriba, en todas partes. Solo tres niveles: plano, elevado (--shadow-raised), superposición (--shadow-overlay).
  • Las sombras son en capas y matizadas: varias capas delgadas, nunca un desenfoque gris. Más alto significa más grande, más suave, más tenue.
  • Las tarjetas y menús usan un anillo de 1px en la sombra en lugar de un borde; los botones sólidos obtienen un sutil resalte interior superior (--shadow-button).
  • Una familia de radios. El radio crece con la elevación (controles, luego tarjetas, luego hojas). Las esquinas anidadas son concéntricas: radio interior = radio exterior menos el relleno entre ellos.
  • En temas oscuros, la profundidad proviene de superficies más claras y el anillo, no de las sombras.
  • Una técnica de profundidad por producto (línea fina, suave, nítida, difusa, plana o labio, establecida por la dirección). Sin brillo, sin sombra en cada tarjeta.
  • El desenfoque y la translucidez pertenecen solo al cromo (un encabezado fijo, una hoja, materiales del sistema), nunca a las tarjetas de contenido.

Detalles: references/premium-craft.md.

8. Componentes

  • Cada elemento interactivo tiene estados: predeterminado, hover, focus-visible, presionado, deshabilitado; cargando para botones; seleccionado para filas y alternadores. Hover nunca es la única señal.
  • Botones y entradas: 40px predeterminado, 32-36px compacto, 44-48px táctil. Relleno horizontal aproximadamente el doble del vertical. Etiqueta = verbo + objeto ("Crear factura"). Los botones solo de icono necesitan aria-label y un tooltip.
  • Anillo de enfoque siempre visible para usuarios de teclado: 2px --focus, desplazamiento de 2px. Nunca outline: none sin un reemplazo.
  • Entradas: etiqueta visible arriba (un placeholder no es una etiqueta), borde --border-strong, texto de ayuda debajo, error debajo con icono y palabras. Los formularios largos añaden un resumen de errores en la parte superior.
  • La acción principal de un formulario (Guardar, Continuar) es visible desde el principio. Puede verse más silenciosa hasta que algo cambie; nunca aparece solo después de una edición.
  • Un interruptor de alternancia entra en vigor de inmediato; una casilla de verificación se aplica al guardar.
  • Tarjetas solo para cosas separadas y comparables. No alrededor de cada sección; nunca tarjetas dentro de tarjetas.
  • Iconos: un conjunto, un grosor de trazo, dimensionados al texto junto a ellos. Nunca emojis como iconos.
  • Imágenes: contenido real, aspect-ratio fijo, alt significativo, un contorno interior de 1px. Sin servicios de placeholder. Sin una foto real todavía, usa un bloque tonal tranquilo en el recorte final con un pequeño título ("Fotografía: sala de jardín"); nunca un dibujo tosco del sujeto, que abarata todo a su alrededor.
  • Modales solo para tareas cortas y enfocadas; prefiere la edición en línea o un panel lateral.
  • Acciones destructivas: color de peligro, nombradas ("Eliminar proyecto"), confirmadas o deshacibles. Deshacer supera a confirmar para acciones frecuentes.

references/forms.md, references/tables-lists.md, references/navigation.md, references/dashboards-charts.md.

9. Estados de retroalimentación

  • Reconoce cada pulsación dentro de los 100ms. Muestra un spinner o esqueleto solo después de ~300ms, luego mantenlo ~500ms.
  • Esqueletos para cargas de página o sección con un diseño conocido; un spinner dentro de botones y widgets pequeños; una barra de progreso con % después de ~10s.
  • Estado vacío = qué es esto + por qué está vacío + una acción. Error = qué sucedió + cómo solucionarlo, en palabras simples, donde sucedió; nunca borres la entrada del usuario.
  • Éxito es silencioso y específico ("Factura 1042 enviada a Anna, 14:02"). Toasts 4-6s, nunca la única copia de información importante.
  • Actualiza optimistamente donde sea seguro, con deshacer en caso de fallo. La velocidad se lee como calidad.

Detalles: references/feedback-states.md.

10. Emoción y confianza

  • Las personas juzgan el aspecto de una pantalla en unos 50ms y ese aspecto es su primera prueba de credibilidad. Simple, familiar en estructura, distintivo en detalle gana.
  • Haz coincidir el diseño con el estado del usuario: ansioso (di qué sucede después, resumen antes de confirmar, camino fácil de regreso), apurado (menos pasos, precargado, atajos), escéptico (prueba junto a afirmaciones, precio completo temprano), experto (densidad, atajos, deshacer en lugar de confirmar), avergonzado o afligido (tono neutral, sin celebración).
  • Termina con fuerza: el último paso y la confirmación son lo que la gente recuerda.
  • El deleite se encuentra en momentos de bajo riesgo (primera ejecución, estado vacío, éxito) y nunca durante errores o tareas sensibles. Cuanto más a menudo sucede algo, más simple es.
  • Rechaza patrones oscuros: urgencia o escasez falsas, reseñas falsas, extras preseleccionados, costos ocultos, difícil de cancelar, confirmación vergonzosa, un gran Aceptar junto a un Rechazar oculto. Ofrece la versión honesta en su lugar.

Detalles: references/psychology-emotion.md.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados