Communitygithub.com

vurakit/agentup

Inteligencia de diseño UI/UX. 50 estilos, 21 paletas, 50 pares tipográficos, 20 gráficos, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Acciones: planificar, construir, crear, diseñar, implementar, revisar, arreglar, mejorar, optimizar, potenciar, refactorizar, verificar código UI/UX. Proyectos: sitio web, página de inicio, dashboard, panel de administración, e-commerce, SaaS, portafolio, blog, aplicación móvil, .html, .tsx, .vue, .svelte. Elementos: botón, modal, barra de navegación, barra lateral, tarjeta, tabla, formulario, gráfico. Estilos: glassmorfismo, claymorfismo, minimalismo, brutalismo, neumorfismo, cuadrícula bento, modo oscuro, responsivo, esqueumorfismo, diseño plano. Temas: paleta de colores, accesibilidad, animación, diseño, tipografía, pares tipográficos, espaciado, hover, sombra, degradado. Integraciones: MCP de shadcn/ui para búsqueda de componentes y ejemplos.

¿Qué es agentup?

Este skill es una guía integral de diseño UI/UX para asistentes de IA como Claude, Cursor o Codex. Proporciona acceso a una base de datos con 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 populares como React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind CSS y shadcn/ui. Su utilidad principal radica en que permite a la IA generar sistemas de diseño completos y coherentes, con recomendaciones priorizadas basadas en el tipo de producto, la industria y las palabras clave del usuario. Funciona mediante un flujo de trabajo de varios pasos: primero analiza los requisitos del usuario, luego genera un sistema de diseño opcionalmente persistente en `MASTER.md` y páginas específicas, y finalmente permite búsquedas detalladas por dominio (estilo, color, tipografía, UX, gráficos) y por stack tecnológico. Incluye un asistente de línea de comandos en Python (`search.py`) que acepta consultas con banderas como `--design-system`, `--persist`, `--domain`, `--stack` y `-f` para formato de salida. El skill también incorpora una lista de verificación previa a la entrega que cubre calidad visual, interacción, modo claro/oscuro, diseño responsivo y accesibilidad, asegurando que el código UI/UX generado sea profesional y esté libre de errores comunes como el uso de emojis como iconos o la falta de contraste.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vurakit/agentup/tree/HEAD/skills/frontend

Preguntar en tu IA favorita

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

Documentación

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

PrioridadCategoríaImpactoDominio
1AccesibilidadCRÍTICOux
2Toque e InteracciónCRÍTICOux
3RendimientoALTOux
4Diseño y ResponsividadALTOux
5Tipografía y ColorMEDIOtipografía, color
6AnimaciónMEDIOux
7Selección de EstiloMEDIOestilo, producto
8Gráficos y DatosBAJOgráfico

Referencia Rápida

1. Accesibilidad (CRÍTICO)

  • color-contraste - Relación mínima 4.5:1 para texto normal
  • estados-foco - Anillos de foco visibles en elementos interactivos
  • texto-alt - Texto alternativo descriptivo para imágenes significativas
  • etiquetas-aria - aria-label para botones solo con icono
  • navegacion-teclado - El orden de tabulación coincide con el orden visual
  • etiquetas-formulario - Usar label con atributo for

2. Toque e Interacción (CRÍTICO)

  • tamano-objetivo-toque - Objetivos táctiles mínimos de 44x44px
  • hover-vs-tap - Usar clic/toque para interacciones principales
  • botones-carga - Deshabilitar botón durante operaciones asíncronas
  • retroalimentacion-error - Mensajes de error claros cerca del problema
  • cursor-puntero - Agregar cursor-pointer a elementos cliqueables

3. Rendimiento (ALTO)

  • optimizacion-imagenes - Usar WebP, srcset, carga diferida
  • movimiento-reducido - Verificar prefers-reduced-motion
  • salto-contenido - Reservar espacio para contenido asíncrono

4. Diseño y Responsividad (ALTO)

  • meta-viewport - width=device-width initial-scale=1
  • tamano-fuente-lectura - Mínimo 16px para texto del cuerpo en móvil
  • desplazamiento-horizontal - Asegurar que el contenido quepa en el ancho del viewport
  • gestion-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 cuerpo
  • longitud-linea - Limitar a 65-75 caracteres por línea
  • pareja-fuentes - Hacer coincidir personalidades de fuente de encabezado/cuerpo

6. Animación (MEDIO)

  • duracion-temporizacion - Usar 150-300ms para microinteracciones
  • rendimiento-transformacion - Usar transform/opacity, no width/height
  • estados-carga - Pantallas esqueleto o spinners

7. Selección de Estilo (MEDIO)

  • coincidencia-estilo - Hacer coincidir el estilo con el tipo de producto
  • consistencia - Usar el mismo estilo en todas las páginas
  • sin-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 datos
  • guia-color - Usar paletas de colores accesibles
  • tabla-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:

  1. Busca en 5 dominios en paralelo (producto, estilo, color, aterrizaje, tipografía)
  2. Aplica reglas de razonamiento desde ui-reasoning.csv para seleccionar las mejores coincidencias
  3. Devuelve un sistema de diseño completo: patrón, estilo, colores, tipografía, efectos
  4. 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ño
  • design-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:

  1. Al construir una página específica (ej., "Checkout"), primero verifique design-system/pages/checkout.md
  2. Si el archivo de página existe, sus reglas anulan el archivo Maestro
  3. 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:

NecesidadDominioEjemplo
Más opciones de estilostyle--domain style "glassmorphism dark"
Recomendaciones de gráficoschart--domain chart "dashboard en tiempo real"
Mejores prácticas de UXux--domain ux "animación accesibilidad"
Fuentes alternativastypography--domain typography "elegante lujo"
Estructura de página de iniciolanding--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

DominioPara qué sirvePalabras clave de ejemplo
productRecomendaciones de tipo de productoSaaS, e-commerce, portafolio, salud, belleza, servicio
styleEstilos UI, colores, efectosglassmorfismo, minimalismo, modo oscuro, brutalismo
typographyPares tipográficos, Google Fontselegante, divertido, profesional, moderno
colorPaletas de colores por tipo de productosaas, ecommerce, salud, belleza, fintech, servicio
landingEstructura de página, estrategias de CTAhero, hero-céntrico, testimonial, precios, prueba-social
chartTipos de gráficos, recomendaciones de libreríastendencia, comparación, línea de tiempo, embudo, pastel
uxMejores prácticas, antipatronesanimación, accesibilidad, z-index, carga
reactRendimiento de React/Next.jscascada, bundle, suspense, memo, rerender, cache
webPautas de interfaz webaria, foco, teclado, semántico, virtualizar
promptPrompts de IA, palabras clave CSS(nombre del estilo)

Stacks Disponibles

StackEnfoque
html-tailwindUtilidades de Tailwind, responsivo, accesibilidad (POR DEFECTO)
reactEstado, hooks, rendimiento, patrones
nextjsSSR, enrutamiento, imágenes, rutas API
vueComposition API, Pinia, Vue Router
svelteRunes, stores, SvelteKit
swiftuiVistas, Estado, Navegación, Animación
react-nativeComponentes, Navegación, Listas
flutterWidgets, Estado, Diseño, Temas
shadcnComponentes shadcn/ui, temas, formularios, patrones
jetpack-composeComposables, 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

  1. Sea específico con las palabras clave - "dashboard SaaS de salud" > "app"
  2. Busque varias veces - Diferentes palabras clave revelan diferentes conocimientos
  3. Combine dominios - Estilo + Tipografía + Color = Sistema de diseño completo
  4. Siempre verifique UX - Busque "animación", "z-index", "accesibilidad" para problemas comunes
  5. Use la bandera de stack - Obtenga mejores prácticas específicas de implementación
  6. 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

ReglaHacerNo Hacer
Sin iconos emojiUsar iconos SVG (Heroicons, Lucide, Simple Icons)Usar emojis como 🎨 🚀 ⚙️ como iconos de UI
Estados hover establesUsar transiciones de color/opacidad en hoverUsar transformaciones de escala que desplacen el diseño
Logotipos de marca correctosInvestigar SVG oficial desde Simple IconsAdivinar o usar rutas de logotipo incorrectas
Tamaño de icono consistenteUsar viewBox fijo (24x24) con w-6 h-6Mezclar diferentes tamaños de icono aleatoriamente

Interacción y Cursor

ReglaHacerNo Hacer
Cursor punteroAgregar cursor-pointer a todas las tarjetas cliqueables/hoverDejar el cursor predeterminado en elementos interactivos
Retroalimentación hoverProporcionar retroalimentación visual (color, sombra, borde)Sin indicación de que el elemento es interactivo
Transiciones suavesUsar transition-colors duration-200Cambios de estado instantáneos o demasiado lentos (>500ms)

Contraste de Modo Claro/Oscuro

ReglaHacerNo Hacer
Tarjeta glass modo claroUsar bg-white/80 o mayor opacidadUsar bg-white/10 (demasiado transparente)
Contraste de texto claroUsar #0F172A (slate-900) para textoUsar #94A3B8 (slate-400) para texto del cuerpo
Texto atenuado claroUsar #475569 (slate-600) como mínimoUsar gray-400 o más claro
Visibilidad del bordeUsar border-gray-200 en modo claroUsar border-white/10 (invisible)

Diseño y Espaciado

ReglaHacerNo Hacer
Barra de navegación flotanteAgregar espaciado top-4 left-4 right-4Pegar la barra de navegación a top-0 left-0 right-0
Relleno de contenidoTener en cuenta la altura de la barra de navegación fijaDejar que el contenido se oculte detrás de elementos fijos
Ancho máximo consistenteUsar el mismo max-w-6xl o max-w-7xlMezclar 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

Skills relacionados