Communitygithub.com

minicoohei/ai-agent-camp

Guía de diseño UI/UX. 50 estilos, 97 paletas, 57 combinaciones tipográficas, 9 stacks compatibles. Se activa con solicitudes como 'Diseña la interfaz', 'Crea un sistema de diseño' o 'Revisa la pantalla'.

¿Qué es ai-agent-camp?

Esta habilidad proporciona un sistema completo de guías de diseño UI/UX para aplicaciones web y móviles. Ofrece una base de datos con más de 50 estilos de interfaz, 97 paletas de colores, 57 combinaciones tipográficas, 99 directrices de experiencia de usuario y 25 tipos de gráficos, organizados en 9 stacks tecnológicos diferentes (HTML+Tailwind, React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, shadcn/ui, Jetpack Compose). Su funcionamiento se basa en un flujo de trabajo estructurado que comienza analizando los requisitos del usuario (tipo de proyecto, palabras clave de estilo, industria, stack). Luego, ejecuta un script de búsqueda por línea de comandos para generar un sistema de diseño completo con recomendaciones razonadas, que incluye patrones, estilos, colores, tipografía, efectos y antipatrones. También permite búsquedas detalladas por dominio (producto, estilo, tipografía, color, landing, gráficos, UX) y soporta la persistencia del sistema de diseño para recuperación jerárquica entre sesiones mediante un patrón maestro/sobrescrituras por página. Es especialmente útil para desarrolladores y diseñadores que trabajan con agentes de IA como Claude Code, Cursor o Codex, ya que proporciona reglas priorizadas (desde críticas como accesibilidad e interacción táctil, hasta baja prioridad como gráficos) y un checklist de verificación previa a la entrega. La habilidad se activa mediante palabras clave como "diseño UI", "revisión UX", "diseño", "página de aterrizaje" y "diseño de pantallas", y está diseñada para integrarse con herramientas MCP como shadcn/ui para búsqueda de componentes y ejemplos.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/minicoohei/ai-agent-camp/tree/HEAD/skills/ui-ux-pro-max

Preguntar en tu IA favorita

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

Documentación

Palabras disparadoras

"Diseño de UI" "Revisión de UX" "Diseño" "Página de aterrizaje" "Diseño de pantallas"

Palabras clave compatibles:

  • Acciones: planificar, construir, crear, diseñar, implementar, revisar, corregir, mejorar, optimizar, potenciar, refactorizar, verificar
  • Proyectos: sitio web, página de aterrizaje, tablero, panel de administración, comercio electrónico, 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: glassmorphism, claymorphism, minimalismo, brutalismo, neumorfismo, cuadrícula bento, modo oscuro, responsivo, esqueumorfismo, diseño plano
  • Temas: paleta de colores, accesibilidad, animación, diseño, tipografía, combinación de fuentes, espaciado, hover, sombra, degradado
  • Integraciones: shadcn/ui MCP para búsqueda de componentes y ejemplos

UI/UX Pro Max - Inteligencia de Diseño

Guía de diseño integral para aplicaciones web y móviles. Contiene más de 50 estilos, 97 paletas de colores, 57 combinaciones tipográficas, 99 directrices de UX y 25 tipos de gráficos en 9 stacks tecnológicos. Base de datos con capacidad de búsqueda y recomendaciones basadas en prioridades.

Cuándo aplicar

Consulte estas directrices al:

  • Diseñar nuevos componentes de UI o páginas
  • Elegir paletas de colores y tipografía
  • Revisar el código en busca de problemas de UX
  • Crear páginas de aterrizaje o tableros
  • Implementar 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 colorMEDIOtypography, color
6AnimaciónMEDIOux
7Selección de estiloMEDIOstyle, product
8Gráficos y datosBAJOchart

Referencia rápida

1. Accesibilidad (CRÍTICO)

  • color-contrast - Mínimo 4.5:1 para texto normal
  • focus-states - Anillos de enfoque visibles en elementos interactivos
  • alt-text - Texto alternativo descriptivo para imágenes significativas
  • aria-labels - aria-label para botones solo con icono
  • keyboard-nav - El orden de tabulación coincide con el orden visual
  • form-labels - Usar label con atributo for

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

  • touch-target-size - Destinos táctiles mínimos de 44x44px
  • hover-vs-tap - Usar clic/toque para interacciones principales
  • loading-buttons - Deshabilitar el botón durante operaciones asíncronas
  • error-feedback - Mensajes de error claros cerca del problema
  • cursor-pointer - Agregar cursor-pointer a elementos cliqueables

3. Rendimiento (ALTO)

  • image-optimization - Usar WebP, srcset, carga diferida
  • reduced-motion - Verificar prefers-reduced-motion
  • content-jumping - Reservar espacio para contenido asíncrono

4. Diseño y responsividad (ALTO)

  • viewport-meta - width=device-width initial-scale=1
  • readable-font-size - Mínimo 16px para texto del cuerpo en móvil
  • horizontal-scroll - Asegurar que el contenido quepa en el ancho de la ventana
  • z-index-management - Definir escala de z-index (10, 20, 30, 50)

5. Tipografía y color (MEDIO)

  • line-height - Usar 1.5-1.75 para el texto del cuerpo
  • line-length - Limitar a 65-75 caracteres por línea
  • font-pairing - Combinar personalidades de fuentes de título/cuerpo

6. Animación (MEDIO)

  • duration-timing - Usar 150-300ms para microinteracciones
  • transform-performance - Usar transform/opacity, no width/height
  • loading-states - Pantallas esqueleto o spinners

7. Selección de estilo (MEDIO)

  • style-match - Hacer coincidir el estilo con el tipo de producto
  • consistency - Usar el mismo estilo en todas las páginas
  • no-emoji-icons - Usar iconos SVG, no emojis

8. Gráficos y datos (BAJO)

  • chart-type - Hacer coincidir el tipo de gráfico con el tipo de datos
  • color-guidance - Usar paletas de colores accesibles
  • data-table - Proporcionar una alternativa de tabla para la accesibilidad

Cómo usar

Busque dominios específicos usando la herramienta de línea de comandos a continuación.


Prerrequisitos

Verifique si Python está instalado:

python3 --version || python --version

Si Python no está instalado, instálelo según el sistema operativo 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 esta habilidad

Cuando el usuario solicite trabajo de UI/UX (diseñar, construir, crear, implementar, revisar, corregir, mejorar), siga este flujo de trabajo:

Paso 1: Analizar los requisitos del usuario

Extraiga la información clave de la solicitud del usuario:

  • Tipo de producto: SaaS, comercio electrónico, portafolio, tablero, página de aterrizaje, etc.
  • Palabras clave de estilo: minimalista, 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 el sistema de diseño (OBLIGATORIO)

Comience siempre con --design-system para obtener recomendaciones completas con razonamiento:

python3 skills/ui-ux-pro-max/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 el sistema de diseño completo: patrón, estilo, colores, tipografía, efectos
  4. Incluye antipatrones a evitar

Ejemplo:

python3 skills/ui-ux-pro-max/scripts/search.py "belleza spa bienestar servicio" --design-system -p "Serenity Spa"

Paso 2b: Persistir el sistema de diseño (Patrón maestro + sobrescrituras)

Para guardar el sistema de diseño para recuperación jerárquica entre sesiones, agregue --persist:

python3 skills/ui-ux-pro-max/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 sobrescrituras específicas de página

Con sobrescritura específica de página:

python3 skills/ui-ux-pro-max/scripts/search.py "<consulta>" --design-system --persist -p "Nombre del proyecto" --page "tablero"

Esto también crea:

  • design-system/pages/tablero.md — Desviaciones específicas de la página respecto al Maestro

Cómo funciona la recuperación jerárquica:

  1. Al construir una página específica (por ejemplo, "Pago"), primero verifique design-system/pages/pago.md
  2. Si el archivo de página existe, sus reglas sobrescriben el archivo Maestro
  3. Si no, use design-system/MASTER.md exclusivamente

Indicación de recuperación contextual:

Estoy construyendo la página [Nombre de la página]. Por favor, lea design-system/MASTER.md.
También verifique si existe design-system/pages/[nombre-página].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 por dominio para obtener más detalles:

python3 skills/ui-ux-pro-max/scripts/search.py "<palabra_clave>" --domain <dominio> [-n <máx_resultados>]

Cuándo usar búsquedas detalladas:

NecesidadDominioEjemplo
Más opciones de estilostyle--domain style "glassmorphism oscuro"
Recomendaciones de gráficoschart--domain chart "tablero en tiempo real"
Mejores prácticas de UXux--domain ux "animación accesibilidad"
Fuentes alternativastypography--domain typography "elegante lujo"
Estructura de aterrizajelanding--domain landing "hero prueba-social"

Paso 4: Directrices del stack (Predeterminado: html-tailwind)

Obtenga las mejores prácticas específicas de implementación. Si el usuario no especifica un stack, use html-tailwind como predeterminado.

python3 skills/ui-ux-pro-max/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

DominioUsoPalabras clave de ejemplo
productRecomendaciones de tipo de productoSaaS, comercio electrónico, portafolio, salud, belleza, servicio
styleEstilos UI, colores, efectosglassmorphism, minimalismo, modo oscuro, brutalismo
typographyCombinaciones de fuentes, Google Fontselegante, divertido, profesional, moderno
colorPaletas de colores por tipo de productosaas, comercio electrónico, salud, belleza, fintech, servicio
landingEstructura de página, estrategias CTAhero, hero-céntrico, testimonio, precios, prueba-social
chartTipos de gráficos, recomendaciones de libreríastendencia, comparación, línea de tiempo, embudo, circular
uxMejores prácticas, antipatronesanimación, accesibilidad, z-index, carga
reactRendimiento de React/Next.jscascada, bundle, suspense, memo, rerender, cache
webDirectrices de interfaz webaria, focus, teclado, semántico, virtualizar
promptPrompts de IA, palabras clave CSS(nombre del estilo)

Stacks disponibles

StackEnfoque
html-tailwindUtilidades Tailwind, responsividad, a11y (PREDETERMINADO)
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-composeComponibles, Modificadores, Elevación de Estado, Recomposición

Flujo de trabajo de ejemplo

Solicitud del usuario: "Crear 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 (predeterminado)

Paso 2: Generar sistema de diseño (OBLIGATORIO)

python3 skills/ui-ux-pro-max/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 directrices de UX sobre animación y accesibilidad
python3 skills/ui-ux-pro-max/scripts/search.py "animación accesibilidad" --domain ux

# Obtener opciones tipográficas alternativas si es necesario
python3 skills/ui-ux-pro-max/scripts/search.py "elegante lujo serif" --domain typography

Paso 4: Directrices del stack

python3 skills/ui-ux-pro-max/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

El flag --design-system admite dos formatos de salida:

# Cuadro ASCII (predeterminado) - mejor para visualización en terminal
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system

# Markdown - mejor para documentación
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown

Consejos para mejores resultados

  1. Sea específico con las palabras clave - "tablero SaaS de salud" > "aplicación"
  2. Busque varias veces - Diferentes palabras clave revelan diferentes perspectivas
  3. Combine dominios - Estilo + Tipografía + Color = Sistema de diseño completo
  4. Verifique siempre la UX - Busque "animación", "z-index", "accesibilidad" para problemas comunes
  5. Use el flag de stack - Obtenga las mejores prácticas específicas de implementación
  6. Itere - Si la primera búsqueda no coincide, pruebe 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 emojis como iconosUsar iconos SVG (Heroicons, Lucide, Simple Icons)Usar emojis como 🎨 🚀 ⚙️ como iconos de UI
Estados hover establesUsar transiciones de color/opacidad al hacer hoverUsar transformaciones de escala que desplacen el diseño
Logotipos de marca correctosInvestigar el SVG oficial de 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 al azar

Interacción y cursor

ReglaHacerNo hacer
Cursor pointerAgregar cursor-pointer a todas las tarjetas cliqueables/hoverablesDejar el cursor predeterminado en elementos interactivos
Feedback al hacer hoverProporcionar feedback 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 modo claro/oscuro

ReglaHacerNo hacer
Tarjeta de cristal en 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 del contenidoTener en cuenta la altura de la barra de navegación fijaDejar que el contenido se esconda 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 el código de la UI, verifique estos puntos:

Calidad visual

  • No se usan emojis como iconos (usar SVG en su lugar)
  • Todos los iconos provienen de un conjunto 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) sin envoltorio var()

Interacción

  • Todos los elementos cliqueables tienen cursor-pointer
  • Los estados hover proporcionan feedback visual claro
  • Las transiciones son suaves (150-300ms)
  • Los estados de enfoque son visibles para la navegación por teclado

Modo claro/oscuro

  • El texto en modo claro tiene suficiente contraste (mínimo 4.5:1)
  • Los elementos de cristal/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
  • No hay contenido oculto detrás de la barra de navegación fija

…

[truncado para traducción]

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados