UI/UX Pro Max - Inteligencia de Diseño
Guía integral de diseño para aplicaciones web y móviles. Contiene más de 50 estilos, 97 paletas de colores, 57 pares tipográficos, 99 pautas de usabilidad y 25 tipos de gráficos distribuidos en 9 stacks tecnológicos. Base de datos buscable con recomendaciones basadas en prioridad.
Cuándo Aplicar
Consulte estas pautas cuando:
- Diseñe nuevos componentes de UI o páginas
- Elija paletas de colores y tipografía
- Revise código en busca de problemas de UX
- Construya páginas de inicio o dashboards
- Implemente requisitos de accesibilidad
Categorías de Reglas por Prioridad
| Prioridad | Categoría | Impacto | Dominio |
|---|---|---|---|
| 1 | Accesibilidad | CRÍTICO | ux |
| 2 | Toque e Interacción | CRÍTICO | ux |
| 3 | Rendimiento | ALTO | ux |
| 4 | Diseño y Responsividad | ALTO | ux |
| 5 | Tipografía y Color | MEDIO | tipografía, color |
| 6 | Animación | MEDIO | ux |
| 7 | Selección de Estilo | MEDIO | estilo, producto |
| 8 | Gráficos y Datos | BAJO | gráfico |
Referencia Rápida
1. Accesibilidad (CRÍTICO)
color-contraste- Relación mínima 4.5:1 para texto normalestados-foco- Anillos de foco visibles en elementos interactivostexto-alt- Texto alternativo descriptivo para imágenes significativasetiquetas-aria-aria-labelpara botones solo con icononavegacion-teclado- El orden de tabulación coincide con el orden visualetiquetas-formulario- Usarlabelcon atributofor
2. Toque e Interacción (CRÍTICO)
tamano-objetivo-toque- Objetivos táctiles mínimos de 44x44pxhover-vs-tap- Usar clic/toque para interacciones principalesbotones-carga- Deshabilitar botón durante operaciones asíncronasretroalimentacion-error- Mensajes de error claros cerca del problemacursor-puntero- Agregarcursor-pointera elementos cliqueables
3. Rendimiento (ALTO)
optimizacion-imagenes- Usar WebP, srcset, carga diferidamovimiento-reducido- Verificarprefers-reduced-motionsalto-contenido- Reservar espacio para contenido asíncrono
4. Diseño y Responsividad (ALTO)
meta-viewport-width=device-width initial-scale=1tamano-fuente-lectura- Mínimo 16px para texto del cuerpo en móvildesplazamiento-horizontal- Asegurar que el contenido quepa en el ancho del viewportgestion-z-index- Definir escala de z-index (10, 20, 30, 50)
5. Tipografía y Color (MEDIO)
altura-linea- Usar 1.5-1.75 para texto del cuerpolongitud-linea- Limitar a 65-75 caracteres por líneapareja-fuentes- Hacer coincidir personalidades de fuente de encabezado/cuerpo
6. Animación (MEDIO)
duracion-temporizacion- Usar 150-300ms para microinteraccionesrendimiento-transformacion- Usartransform/opacity, nowidth/heightestados-carga- Pantallas esqueleto o spinners
7. Selección de Estilo (MEDIO)
coincidencia-estilo- Hacer coincidir el estilo con el tipo de productoconsistencia- Usar el mismo estilo en todas las páginassin-iconos-emoji- Usar iconos SVG, no emojis
8. Gráficos y Datos (BAJO)
tipo-grafico- Hacer coincidir el tipo de gráfico con el tipo de datosguia-color- Usar paletas de colores accesiblestabla-datos- Proporcionar alternativa de tabla para accesibilidad
Cómo Usar
Busque dominios específicos usando la herramienta CLI a continuación.
Prerrequisitos
Verifique si Python está instalado:
python3 --version || python --version
Si Python no está instalado, instálelo según el SO del usuario:
macOS:
brew install python3
Ubuntu/Debian:
sudo apt update && sudo apt install python3
Windows:
winget install Python.Python.3.12
Cómo Usar Este Skill
Cuando el usuario solicite trabajo de UI/UX (diseñar, construir, crear, implementar, revisar, arreglar, mejorar), siga este flujo de trabajo:
Paso 1: Analizar Requisitos del Usuario
Extraiga información clave de la solicitud del usuario:
- Tipo de producto: SaaS, e-commerce, portafolio, dashboard, página de inicio, etc.
- Palabras clave de estilo: minimal, divertido, profesional, elegante, modo oscuro, etc.
- Industria: salud, fintech, juegos, educación, etc.
- Stack: React, Vue, Next.js, o por defecto
html-tailwind
Paso 2: Generar Sistema de Diseño (REQUERIDO)
Siempre comience con --design-system para obtener recomendaciones completas con razonamiento:
python3 skills/agentup-frontend/scripts/search.py "<tipo_producto> <industria> <palabras_clave>" --design-system [-p "Nombre del Proyecto"]
Este comando:
- Busca en 5 dominios en paralelo (producto, estilo, color, aterrizaje, tipografía)
- Aplica reglas de razonamiento desde
ui-reasoning.csvpara seleccionar las mejores coincidencias - Devuelve un sistema de diseño completo: patrón, estilo, colores, tipografía, efectos
- Incluye antipatrones a evitar
Ejemplo:
python3 skills/agentup-frontend/scripts/search.py "spa de belleza y bienestar servicio" --design-system -p "Serenity Spa"
Paso 2b: Persistir Sistema de Diseño (Patrón Maestro + Anulaciones)
Para guardar el sistema de diseño para recuperación jerárquica entre sesiones, agregue --persist:
python3 skills/agentup-frontend/scripts/search.py "<consulta>" --design-system --persist -p "Nombre del Proyecto"
Esto crea:
design-system/MASTER.md— Fuente de Verdad Global con todas las reglas de diseñodesign-system/pages/— Carpeta para anulaciones específicas de página
Con anulación específica de página:
python3 skills/agentup-frontend/scripts/search.py "<consulta>" --design-system --persist -p "Nombre del Proyecto" --page "dashboard"
Esto también crea:
design-system/pages/dashboard.md— Desviaciones específicas de página del Maestro
Cómo funciona la recuperación jerárquica:
- Al construir una página específica (ej., "Checkout"), primero verifique
design-system/pages/checkout.md - Si el archivo de página existe, sus reglas anulan el archivo Maestro
- Si no, use exclusivamente
design-system/MASTER.md
Prompt de recuperación consciente del contexto:
Estoy construyendo la página [Nombre de Página]. Por favor, lea design-system/MASTER.md.
También verifique si existe design-system/pages/[nombre-pagina].md.
Si el archivo de página existe, priorice sus reglas.
Si no, use las reglas del Maestro exclusivamente.
Ahora, genere el código...
Paso 3: Complementar con Búsquedas Detalladas (según sea necesario)
Después de obtener el sistema de diseño, use búsquedas de dominio para obtener detalles adicionales:
python3 skills/agentup-frontend/scripts/search.py "<palabra_clave>" --domain <dominio> [-n <max_resultados>]
Cuándo usar búsquedas detalladas:
| Necesidad | Dominio | Ejemplo |
|---|---|---|
| Más opciones de estilo | style | --domain style "glassmorphism dark" |
| Recomendaciones de gráficos | chart | --domain chart "dashboard en tiempo real" |
| Mejores prácticas de UX | ux | --domain ux "animación accesibilidad" |
| Fuentes alternativas | typography | --domain typography "elegante lujo" |
| Estructura de página de inicio | landing | --domain landing "hero prueba-social" |
Paso 4: Pautas del Stack (Por defecto: html-tailwind)
Obtenga mejores prácticas específicas de implementación. Si el usuario no especifica un stack, use por defecto html-tailwind.
python3 skills/agentup-frontend/scripts/search.py "<palabra_clave>" --stack html-tailwind
Stacks disponibles: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter, shadcn, jetpack-compose
Referencia de Búsqueda
Dominios Disponibles
| Dominio | Para qué sirve | Palabras clave de ejemplo |
|---|---|---|
product | Recomendaciones de tipo de producto | SaaS, e-commerce, portafolio, salud, belleza, servicio |
style | Estilos UI, colores, efectos | glassmorfismo, minimalismo, modo oscuro, brutalismo |
typography | Pares tipográficos, Google Fonts | elegante, divertido, profesional, moderno |
color | Paletas de colores por tipo de producto | saas, ecommerce, salud, belleza, fintech, servicio |
landing | Estructura de página, estrategias de CTA | hero, hero-céntrico, testimonial, precios, prueba-social |
chart | Tipos de gráficos, recomendaciones de librerías | tendencia, comparación, línea de tiempo, embudo, pastel |
ux | Mejores prácticas, antipatrones | animación, accesibilidad, z-index, carga |
react | Rendimiento de React/Next.js | cascada, bundle, suspense, memo, rerender, cache |
web | Pautas de interfaz web | aria, foco, teclado, semántico, virtualizar |
prompt | Prompts de IA, palabras clave CSS | (nombre del estilo) |
Stacks Disponibles
| Stack | Enfoque |
|---|---|
html-tailwind | Utilidades de Tailwind, responsivo, accesibilidad (POR DEFECTO) |
react | Estado, hooks, rendimiento, patrones |
nextjs | SSR, enrutamiento, imágenes, rutas API |
vue | Composition API, Pinia, Vue Router |
svelte | Runes, stores, SvelteKit |
swiftui | Vistas, Estado, Navegación, Animación |
react-native | Componentes, Navegación, Listas |
flutter | Widgets, Estado, Diseño, Temas |
shadcn | Componentes shadcn/ui, temas, formularios, patrones |
jetpack-compose | Composables, Modificadores, Elevación de Estado, Recomposición |
Flujo de Trabajo de Ejemplo
Solicitud del usuario: "Haz una página de aterrizaje para un servicio de cuidado de la piel profesional"
Paso 1: Analizar Requisitos
- Tipo de producto: Servicio de Belleza/Spa
- Palabras clave de estilo: elegante, profesional, suave
- Industria: Belleza/Bienestar
- Stack: html-tailwind (por defecto)
Paso 2: Generar Sistema de Diseño (REQUERIDO)
python3 skills/agentup-frontend/scripts/search.py "belleza spa bienestar servicio elegante" --design-system -p "Serenity Spa"
Salida: Sistema de diseño completo con patrón, estilo, colores, tipografía, efectos y antipatrones.
Paso 3: Complementar con Búsquedas Detalladas (según sea necesario)
# Obtener pautas de UX para animación y accesibilidad
python3 skills/agentup-frontend/scripts/search.py "animación accesibilidad" --domain ux
# Obtener opciones tipográficas alternativas si es necesario
python3 skills/agentup-frontend/scripts/search.py "elegante lujo serif" --domain typography
Paso 4: Pautas del Stack
python3 skills/agentup-frontend/scripts/search.py "diseño responsivo formulario" --stack html-tailwind
Luego: Sintetizar el sistema de diseño + búsquedas detalladas e implementar el diseño.
Formatos de Salida
La bandera --design-system admite dos formatos de salida:
# Caja ASCII (por defecto) - mejor para visualización en terminal
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system
# Markdown - mejor para documentación
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system -f markdown
Consejos para Mejores Resultados
- Sea específico con las palabras clave - "dashboard SaaS de salud" > "app"
- Busque varias veces - Diferentes palabras clave revelan diferentes conocimientos
- Combine dominios - Estilo + Tipografía + Color = Sistema de diseño completo
- Siempre verifique UX - Busque "animación", "z-index", "accesibilidad" para problemas comunes
- Use la bandera de stack - Obtenga mejores prácticas específicas de implementación
- Itere - Si la primera búsqueda no coincide, intente con diferentes palabras clave
Reglas Comunes para UI Profesional
Estos son problemas que se pasan por alto con frecuencia y que hacen que la UI parezca poco profesional:
Iconos y Elementos Visuales
| Regla | Hacer | No Hacer |
|---|---|---|
| Sin iconos emoji | Usar iconos SVG (Heroicons, Lucide, Simple Icons) | Usar emojis como 🎨 🚀 ⚙️ como iconos de UI |
| Estados hover estables | Usar transiciones de color/opacidad en hover | Usar transformaciones de escala que desplacen el diseño |
| Logotipos de marca correctos | Investigar SVG oficial desde Simple Icons | Adivinar o usar rutas de logotipo incorrectas |
| Tamaño de icono consistente | Usar viewBox fijo (24x24) con w-6 h-6 | Mezclar diferentes tamaños de icono aleatoriamente |
Interacción y Cursor
| Regla | Hacer | No Hacer |
|---|---|---|
| Cursor puntero | Agregar cursor-pointer a todas las tarjetas cliqueables/hover | Dejar el cursor predeterminado en elementos interactivos |
| Retroalimentación hover | Proporcionar retroalimentación visual (color, sombra, borde) | Sin indicación de que el elemento es interactivo |
| Transiciones suaves | Usar transition-colors duration-200 | Cambios de estado instantáneos o demasiado lentos (>500ms) |
Contraste de Modo Claro/Oscuro
| Regla | Hacer | No Hacer |
|---|---|---|
| Tarjeta glass modo claro | Usar bg-white/80 o mayor opacidad | Usar bg-white/10 (demasiado transparente) |
| Contraste de texto claro | Usar #0F172A (slate-900) para texto | Usar #94A3B8 (slate-400) para texto del cuerpo |
| Texto atenuado claro | Usar #475569 (slate-600) como mínimo | Usar gray-400 o más claro |
| Visibilidad del borde | Usar border-gray-200 en modo claro | Usar border-white/10 (invisible) |
Diseño y Espaciado
| Regla | Hacer | No Hacer |
|---|---|---|
| Barra de navegación flotante | Agregar espaciado top-4 left-4 right-4 | Pegar la barra de navegación a top-0 left-0 right-0 |
| Relleno de contenido | Tener en cuenta la altura de la barra de navegación fija | Dejar que el contenido se oculte detrás de elementos fijos |
| Ancho máximo consistente | Usar el mismo max-w-6xl o max-w-7xl | Mezclar diferentes anchos de contenedor |
Lista de Verificación Previa a la Entrega
Antes de entregar código UI, verifique estos elementos:
Calidad Visual
- No se usan emojis como iconos (usar SVG en su lugar)
- Todos los iconos provienen de un conjunto de iconos consistente (Heroicons/Lucide)
- Los logotipos de marca son correctos (verificados desde Simple Icons)
- Los estados hover no causan desplazamiento del diseño
- Usar colores del tema directamente (bg-primary) no con envoltura var()
Interacción
- Todos los elementos cliqueables tienen
cursor-pointer - Los estados hover proporcionan retroalimentación visual clara
- Las transiciones son suaves (150-300ms)
- Los estados de foco son visibles para navegación por teclado
Modo Claro/Oscuro
- El texto en modo claro tiene suficiente contraste (mínimo 4.5:1)
- Los elementos glass/transparentes son visibles en modo claro
- Los bordes son visibles en ambos modos
- Probar ambos modos antes de la entrega
Diseño
- Los elementos flotantes tienen el espaciado adecuado desde los bordes
- Ningún contenido oculto detrás de barras de navegación fijas
- Responsivo a 375px, 768px, 1024px, 1440px
- Sin desplazamiento horizontal en móvil
Accesibilidad
- Todas las imágenes tienen texto alternativo
- Las entradas de formulario tienen etiquetas
- El color no es el único indicador
- Se respeta
prefers-reduced-motion