Communitygithub.com

lidge-ai/ima2-gen

Descubrimiento de dirección de diseño y juicio de UX para usuarios de ima2. Úsalo para dirección de UI/UX y juicio de diseño — briefs visuales vagos, onboarding, estados vacío/error/carga, vocabulario de layout, saltos de tipografía, favicons, logotipos y decisiones de identidad de marca.

¿Qué es ima2-gen?

Este skill, `lidge-ai/ima2-gen`, está diseñado para guiar a agentes de IA en la toma de decisiones de diseño de interfaz y experiencia de usuario (UI/UX) para la plataforma ima2. Su función principal es interpretar solicitudes vagas o complejas sobre la dirección visual de un producto — como 'hazlo ver moderno y limpio' o referencias a la estética de otras aplicaciones — y traducirlas en una dirección de diseño concreta y fundamentada. Esto incluye la selección de paletas de color, tipografía, patrones de layout, arquitectura de información y la definición de la personalidad de la marca. El skill se apoya en una extensa biblioteca de referencias modulares que cubren desde movimientos de diseño y fuentes de inspiración premiadas hasta sistemas de color basados en OKLCH y patrones de UX para estados como onboarding o carga. Una vez que se establece la dirección de diseño, el skill recomienda cargar `ima2-front` para la implementación técnica real en HTML y CSS, manteniendo una clara separación de roles: este skill decide el 'qué' y el 'por qué', mientras que `ima2-front` se encarga del 'cómo'. También incluye reglas estrictas contra ciertos patrones considerados de baja calidad o 'slop', como el uso de emojis como elementos visuales de UI o paletas de un solo tono, y promueve un enfoque de diseño centrado en la eficiencia cognitiva del usuario, priorizando la simplicidad y las acciones por defecto sobre opciones complejas.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lidge-ai/ima2-gen/tree/HEAD/skills/ima2-uiux

Preguntar en tu IA favorita

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

Documentación

ima2 UI/UX: Descubrimiento de Intención, Patrones y Vocabulario de Producto

Configuración

npm install -g ima2-gen    # instalar globalmente (Node.js >= 20)
ima2 setup                 # autenticación inicial (se recomienda OAuth de GPT)
ima2 serve                 # iniciar servidor local
ima2 ping                  # verificar
ima2 status                # estado de configuración y OAuth

Arranque del agente: ejecuta ima2 ping primero. Si no responde: ima2 serve &. Si no está instalado: npm install -g ima2-gen && ima2 setup. Usa ima2 skill path para localizar los skills; lee ../ima2-uiux/SKILL.md (este archivo) para la dirección de diseño, ../ima2-front/SKILL.md para los activos de implementación.

Se activa según la superficie de cambio cuando:

  • La dirección de diseño del usuario es vaga ("깔끔하게", "모던하게", "solo haz que se vea bien")
  • Se está construyendo UI de onboarding, estado vacío, estado de error o estado de carga
  • El usuario hace referencia a la estética de un producto ("estilo Notion", "como Linear")
  • Se inicia un nuevo sistema de diseño o se genera una paleta de colores
  • Se eligen patrones de layout o arquitectura de navegación
  • Se configuran favicons, logotipos de producto o elementos de identidad de marca
  • Se manejan variantes de modo oscuro de logotipos, imágenes OG o metadatos de redes sociales

Léelo antes de referencias de estilo específicas cuando el usuario no pueda articular una dirección de diseño clara. Para la detección de 'slop' y patrones prohibidos, remítete a ima2 skill front ref anti-slop, especialmente el presupuesto de degradados de 2026 y la prohibición de temas de una sola nota.

Prohibición de emojis (resumen): no se permiten emojis como elementos visuales de UI (ESTRICTO). Regla canónica, alcance y exenciones: ima2-front §5 / ima2 skill front ref anti-slop § Emoji Slop.

Separación de roles: Este skill posee el juicio de diseño: descubrimiento de intención, arquitectura de información, significado del estado de UX, dirección de tipografía/color/layout, personalidad del producto, vocabulario de marca, juicio de patrones anti-slop y decisiones del sistema de diseño. ima2-front posee la implementación: HTML/CSS/componentes, mecánicas responsivas, cableado de accesibilidad, comportamiento en tiempo de ejecución y verificación renderizada. Después de elegir la dirección de diseño aquí, carga ima2-front para la implementación concreta.

Evidencia externa/actual de diseño: Para afirmaciones de referencia a productos en vivo, documentación actual de sistemas de diseño, comportamiento de API del navegador, guías de accesibilidad que puedan haber cambiado o evidencia de fuente renderizada en navegador, busca en la web y sigue sus reglas de reescritura de consultas, obtención de fuentes y estado de evidencia. Usa browser fetch/open/text/get-dom/snapshot solo después de que existan URLs candidatas.

Trabajo C0/C1 (parches locales pequeños): Para parches pequeños, omite la cadena de referencia completa.

Nota de clase de regla (UX-STYLE-01): Todo en este skill que exprese gusto — personalidades de producto, ismos de diseño, tokens preestablecidos, vocabulario estético — es STYLE_SAMPLE: ejemplos de los que basarse, nunca requisitos universales. La corrección objetiva de UX (cobertura de estados, accesibilidad, legibilidad) es propiedad de ima2-front §1.5 y se mantiene como ESTRICTO/PREDETERMINADO.

Referencias Modulares

Recomendado: instala los skills en el directorio de skills de tu agente.

ima2 skill install --dir <ruta-del-skill-del-agente>   # el agente proporciona su propia ruta
ima2 skill install --tmp                                # fallback efímero

El agente determina su propio directorio de skills y lo pasa mediante --dir. Después de la instalación, SKILL.md y references/ están en disco para lectura nativa.

Lectura ad-hoc (sin instalación):

ima2 skill uiux refs              # lista todos los módulos de referencia con recuento de líneas
ima2 skill uiux ref design-isms   # imprime un módulo (coincidencia de nombre base)
ArchivoCuándo LeerloQué Cubre
references/design-isms.mdEl usuario nombra un estilo/movimiento16 movimientos de diseño con firmas CSS, incl. Liquid Glass + kit predeterminado Liquid Editorial (2025-2026) + AI Serif Editorial + Organic Capsule (verificado 2026-07-09)
references/design-award-sources.mdBuscando referencias de diseño realesGuía de fuentes por niveles: sitios de premios y galerías, para qué es mejor cada uno y cómo buscar
references/compositional-patterns.mdComponiendo hero, navegación, movimiento o estructura de contenidoPatrones compositivos canónicos de investigación de premios con puertas de acceso responsivas y de accesibilidad
references/design-trends.mdVerificando prevalencia fechada, técnicas emergentes o estado de promociónInstantánea del eje de frecuencia 2026-07-14, señales de técnica, libro de firmas y protocolo de re-rastreo
references/design-read-example.mdAprendiendo o revisando el formato Design ReadEjemplo de Design Read completo + configuración de dial
references/product-personalities.mdEl usuario hace referencia a un producto10 perfiles de ADN de producto con tokens exactos, incl. pastel de producto AI 2026 + orgánico warm-sans de OpenAI + serif bookish de Anthropic
references/layout-macrostructures.mdEligiendo layout de página/componenteLayouts de componente + composiciones a nivel de página
references/ux-states.mdConstruyendo cualquier UI con estadoOnboarding, vacío, error, carga, divulgación progresiva
references/color-system.mdGenerando colores/paletasGeneración de paletas basada en OKLCH, presupuesto de matiz, neutros teñidos, modo oscuro, accesibilidad
references/design-system-bootstrap.mdNuevo proyecto / sistema de diseñoArquitectura de tokens, jerarquía de componentes, formato DESIGN.md (google-labs-code/design.md)
references/responsive-nav.mdTrabajo responsivo o de navegaciónPuntos de quiebre, consultas de contenedor, patrones de nav por densidad
references/ux-preflight.mdAntes de la entregaLista de verificación de estado de UX
references/typography-line-breaks.mdSiempre para UI con mucho textoCalidad de saltos de encabezado, categoría de descriptor corto (subtítulo de hero, descripción de tarjeta — usa balance no pretty), prevención de huérfanos, unidades ch, criterios de huérfanos en coreano, conflicto -webkit-line-clamp
references/favicon-logo.mdTrabajo de favicon, logotipo de producto o identidad de marcaConjunto de archivos de favicon, modo oscuro SVG, logotipo en nav/footer, variantes de modo oscuro, imágenes OG, tokens de marca, errores comunes
references/logo-trust-sections.mdLogotipos de integración/socio/clienteDecisión entre marquesina y cuadrícula, anti-patrones, tratamiento en escala de grises, ubicación
references/visual-hierarchy.mdCualquier decisión de layout / composición6 palancas: escala de tamaño, contraste de peso, énfasis de color, espaciado, posición, densidad
references/form-patterns.mdFormularios, asistentes, autenticación, carga de archivosMomento de la validación, múltiples pasos, UX de contraseñas, carga de archivos, búsqueda/filtro
references/mobile-native-ux.mdDecisiones de UX para aplicaciones móviles nativasiOS HIG vs Material 3, gestos, enlaces profundos, privacidad en coreano, UX de tienda de aplicaciones
references/intent-discovery-ladder.mdProfundización opcional UX-INTENT-01 (Pasos 1-6)Escalera de estado de ánimo/luminosidad/densidad/forma/viewport/referencia, desambiguación de solicitudes vagas
references/korean-design-vocabulary.mdBriefs de diseño en coreano o UI primero-coreanoTraducción de descriptor coreano → token CSS, tabla de coincidencia rápida, pautas de selección de fuentes

Puerta de Usuario Perezoso (UX-LAZY-01, PREDETERMINADO — disciplina de la coleta aplicada a UX)

Diseña para el usuario cognitivamente frugal: los usuarios no leen, escanean; se satisfacen; intercambiarán elección por una acción obvia a seguir. Antes de enviar cualquier punto de decisión orientado al usuario — opción, configuración, paso, confirmación, campo de entrada, modo — justifica su existencia a la manera de la coleta, en orden:

  1. No hacer nada: ¿puede un valor predeterminado correcto eliminar esta decisión por completo?
  2. Eliminar: ¿el paso/campo se gana su costo en la tasa de finalización (ley de Hick)?
  3. Absorber: ¿puede el sistema tomar la complejidad en lugar del usuario (ley de Tesler)?
  4. Degradar: aún necesario para algunos usuarios → divulgación progresiva, nunca una bifurcación de nivel superior.

Cada pantalla tiene UNA acción principal. Condicional de superficie: los flujos de consumo/de un solo uso minimizan las DECISIONES; las herramientas de trabajo repetitivo (perfiles densos) minimizan los MOVIMIENTOS repetidos — colapsar controles expertos en asistentes es el fallo inverso. Exenciones ESTRICTAS: acciones destructivas/irreversibles, consentimiento/privacidad/legal, confirmación de pagos y provisiones de accesibilidad nunca se colapsan en valores predeterminados mágicos.

Contrato de Estado de UX (UX-STATE-01)

Para trabajo de onboarding, vacío, carga, error o divulgación progresiva, el cuerpo debe responder al significado del estado antes que al estilo. Los patrones profundos residen en references/ux-states.md.

  • Onboarding enseña la primera acción significativa, no todo el producto.
  • Vacío explica por qué existe el estado y nombra la siguiente acción.
  • Carga elige esqueleto para estructura conocida, spinner/progreso para esperas desconocidas cortas, y evita la finalización falsa.
  • Error expone reintento, recuperación o escalamiento; nunca deja al usuario sin salida.
  • Divulgación progresiva nombra lo que permanece oculto, por qué permanece oculto y dónde estará disponible.

Selector de IA (UX-IA-01)

Arquitectura de navegación predeterminada según la forma de trabajo; lee references/responsive-nav.md para detalles responsivos.

Forma de trabajoIA predeterminada
Trabajo repetitivo denso de escritorioBarra lateral + paleta de comandos
Trabajo seccionado medianoPestañas o navegación segmentada
Flujo de consumo principalmente móvilNavegación inferior, hoja o acciones en zona del pulgar
Asistente/autenticación/configuraciónStepper o flujo lineal apilado

1. Protocolo de Descubrimiento de Intención del Usuario

Cuando la solicitud de diseño del usuario es vaga ("깔끔하게 해줘", "모던하게", "solo haz que se vea bien"), no produzcas una salida genérica. Ejecuta el flujo de ambigüedad compacto (UX-INTENT-01):

  1. Produce el Design Read de la §2 usando las señales disponibles.
  2. Si una decisión aún bloquea la dirección, haz UNA pregunta de la mejor bifurcación aclaratoria con opciones binarias/ternarias.
  3. Procede con la respuesta; si el usuario no responde y la tarea puede continuar, elige el valor predeterminado más correcto para el dominio y establece la suposición. En superficies EXPRESIVAS (landing/consumo/creativo/producto-AI), ese valor predeterminado es la Dirección Predeterminada Sin Brief a continuación (UX-DEFAULT-ISM-01); las superficies tranquilas mantienen valores predeterminados correctos para el dominio tranquilos.

Omite esta sección si el usuario proporcionó especificaciones de diseño explícitas o si se trata de un parche de ≤5 líneas.

Dirección Predeterminada Sin Brief (UX-DEFAULT-ISM-01, PREDETERMINADO — contenido del kit STYLE_SAMPLE)

Este es el PASO-3 de RESERVA de UX-INTENT-01, nunca un bypass: se activa solo después del Design Read y después de que la bifurcación bloqueante se resuelva o quede sin respuesta, y la dirección aplicada SIEMPRE se declara como una suposición explícita en el entregable. Una dirección nombrada, específica y limitada por dominio reemplaza los valores predeterminados genéricos del LLM; NO debe reintroducir el gusto genérico de vidrio esmerilado/tarjeta centrada/beige predeterminado bajo una nueva etiqueta.

Kit predeterminado para superficies expresivas: Liquid Editorial (compuesto 2026, decidido 2026-07-07 a partir de investigación de tendencias de Nivel 2 — consulta references/design-isms.md §1.14 para la firma completa):

  • Estructura: composición editorial liderada por tipografía (escala de encabezado de autor sobredimensionada, grotesk predeterminado, serif display solo con justificación editorial según UX-TYPE-01), textura táctil/fotográfica sobre lavados de degradado plano, layout asimétrico con peso en el contenido.
  • Acento material: Liquid Glass o cromo de píldora casi opaco SOLO en capas funcionales flotantes (nav/barras de herramientas/grupos de chips); unidades de contenido de píldora de chip; la capa de contenido permanece sólida (ima2-front FE-LIQUID-LAYER-01). Los hijos dentro del cromo de píldora no llevan bordes/contornos de cápsula en reposo — énfasis solo mediante rellenos/matices (ima2-front FE-PILL-NEST-01); estados de desplazamiento de la barra superior según ima2-front/references/top-bar.md FE-TOPBAR-STATE-01.
  • Movimiento: línea base de retroalimentación + un momento de firma (chips de proximidad del puntero o revelación impulsada por desplazamiento) + >= 1 revelación de desplazamiento de apoyo en superficies de cubo de aterrizaje (piso 2, techo ~4 — ima2-front/references/motion.md FE-MOTION-BUCKET-01); solo retroalimentación en otros lugares, según las puertas de dominio de movimiento.
  • Color: acento único derivado de OKLCH + neutros teñidos (presupuesto de matiz, references/color-system.md).

Puerta de dominio (ESTRICTO): los paneles de control, administración, operaciones, finanzas, gobierno y herramientas de trabajo repetitivo B2B NUNCA reciben este kit por defecto — "elegante" nunca anula la corrección del dominio (§ Selector de IA + perfiles de densidad de producto de ima2-front).

Profundización opcional: usa la escalera a continuación solo cuando la primera bifurcación falla o el usuario quiere explícitamente una exploración guiada.

  • Usa opciones binarias/ternarias, no preguntas abiertas.
  • Haz referencia a productos conocidos: los usuarios reconocen lo que quieren más rápido de lo que lo articulan.
  • Si el skill de diagramas está disponible, ofrece: "참고로 스타일 비교를 다이어그램으로 보여드릴 수도 있어요."
  • Si el usuario nombra una referencia de producto específica, omite los pasos restantes y mapea directamente mediante references/product-personalities.md.

Para la escalera guiada completa de 6 pasos (Estado de Ánimo → Luminosidad → Densidad → Forma → Viewport → Referencia) y la tabla de desambiguación de solicitudes vagas, lee references/intent-discovery-ladder.md. Cárgala solo cuando el flujo compacto anterior necesite una exploración guiada más profunda.


2. Design Read (OBLIGATORIO para páginas, componentes o layouts nuevos. Opcional para parches de ≤5 líneas — consulta la sección de desarrollo §0.1 Ruta Rápida de Parches.)

Antes de generar CUALQUIER código frontend, produce un Design Read. Si el proyecto tiene un archivo DESIGN.md, léelo primero — sus tokens y prosa anulan todo lo siguiente.

Soporte de herramientas nativas (estructura/60): lee referencias visuales — pantallas existentes, capturas de competidores, exportaciones de diseño — en contexto con view_image antes de escribir el Design Read; produce los activos de mapa de bits necesarios (iconos, ilustraciones, imágenes simuladas) con ima2 (prueba ima2 status, intenta ima2 serve si está caído; ima2 es la herramienta principal solo cuando ima2 no está realmente disponible) en lugar de dejar cuadros de marcador de posición; y verifica el resultado construido visualmente según la verificación visual (captura de pantalla del navegador -> view_image).

Formato de salida (mini DESIGN.md)

Ejemplo completo: references/design-read-example.md.

---
name: <nombre-del-proyecto>
colors:
  primary: "<hex>"
  accent: "<hex>"
  background: "<hex>"
typography:
  heading: { fontFamily: <fuente>, fontSize: <tamaño> }
  body: { fontFamily: <fuente>, fontSize: <tamaño> }
---

Leyendo esto como: <tipo de página> para , con un lenguaje de . <1-2 oraciones: referencia específica, no adjetivos. "Folleto de clase de los 70" > "moderno y limpio">

Hacer: <positivo específico del contexto del brief> No hacer: <negativo específico del contexto del brief> ...

Skills relacionados