Communitygithub.com

ui-roast

Analiza y critica una IU/UX (captura, descripción, código de componente o app en ejecución) desde cuatro perspectivas (IU, UX, Sensación/animación, Estilo) con críticas divertidas pero específicas y honestas, y convierte cada crítica en un prompt de corrección listo para usar, escrito con principios de diseño.

¿Qué es ui-roast?

Esta habilidad para agentes de IA está diseñada para evaluar y criticar interfaces de usuario y experiencias de usuario (IU/UX) de manera exhaustiva. Acepta diversos formatos de entrada: capturas de pantalla, imágenes, archivos de componentes de código, descripciones de animaciones o aplicaciones en ejecución. El agente analiza el diseño a través de cuatro lentes específicos: Jerarquía y espaciado (IU), Flujo de tareas y estados (UX), Animaciones y gestos (Sensación), y Coherencia visual (Estilo). Para cada hallazgo, genera una crítica humorística pero fundamentada, seguida de un prompt de corrección práctico y detallado que el usuario puede pegar directamente en una sesión de codificación. La habilidad incluye reglas estrictas para evitar criticar al creador, inventar problemas o ser vago. Está optimizada para usar con Claude Code, Cursor y otras herramientas de desarrollo, y su proceso incluye pasos para evaluar animaciones a partir de código, grabaciones de pantalla o descripciones, priorizando siempre las fuentes de evidencia más directas.

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

Preguntar en tu IA favorita

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

Documentación

UI Roast (Crítica de IU)

Entrada: algo visual o interactivo. Una ruta de captura de pantalla, una imagen pegada, un archivo de componente o pantalla, una descripción de cómo se mueve, o una aplicación en ejecución a la que el usuario apunte. Salida: una crítica breve y clasificada, donde cada broma está vinculada a un hallazgo real y cada hallazgo termina con un prompt de corrección que el usuario puede pegar en una sesión de codificación.

Los prompts de corrección siguen el estilo de design-prompt-rewriter: simples, específicos, con vocabulario de diseño, un párrafo corto cada uno. Fuente de vocabulario: references/keywords.md.

Proceso

  1. Mira primero. Imagen: léela. Código: lee el archivo de pantalla y su código de estilos/animación. Aplicación en ejecución: usa la habilidad de ejecución o las capturas de pantalla del usuario. No critiques solo a partir de la descripción si lo real está disponible.
  2. Revisa la lista de verificación a continuación. Solo informa sobre lo que realmente ves o lees. Nunca inventes un problema para rellenar la lista.
  3. Clasifica por impacto en el usuario, no por lo graciosa que sea la broma. Máximo 5 críticas. Si hay más, mantenlas en una lista de una línea "También detectado" al final.
  4. Escribe cada crítica en el formato a continuación.
  5. Cierra con un prompt combinado que solucione los problemas principales juntos, para que el usuario pueda pegar un solo bloque.

No edites archivos ni escribas código a menos que el usuario lo pida después de la crítica.

Lista de verificación (cubre cada perspectiva: IU, UX, Sensación, Estilo)

Mapa de perspectivas, utilizado para etiquetar cada crítica: IU = 1 a 4, 9 · UX = 5, 6, 10, 11, 12, 13, 15 · Sensación = 7, 8 · Estilo = 14.

  1. Jerarquía: ¿puedes saber en 2 segundos para qué es la pantalla y qué tocar primero? ¿Una acción principal clara?
  2. Espaciado y alineación: escala consistente de 4/8 pt, bordes alineados, suficiente espacio en blanco, nada apretado o flotando.
  3. Tipografía: demasiados tamaños o pesos, texto pequeño, mala longitud de línea, truncamiento, sin escala para tipo dinámico.
  4. Color y contraste: contraste de texto 4.5:1, significado solo por color, colores únicos sin referencia frente a tokens de diseño, modo oscuro.
  5. Objetos táctiles y capacidad de respuesta: mínimo 44pt / 48dp, un botón parece un botón, estados presionados.
  6. Retroalimentación y estados: carga (esqueleto vs. blanco), vacío, error con reintento, éxito, deshabilitado, fuera de línea.
  7. Animación (si es visible o está en el código): easing lineal, duraciones menores de 150 ms o mayores de 500 ms, sin escalonamiento, sin capacidad de interrupción, falta de impulso después de gestos, cambio de diseño, animación de ancho/alto en lugar de transform/opacidad, parpadeo al cambiar de estado.
  8. Gestos y desplazamiento: gestos conflictivos, sin impulso, sin efecto de goma, falta de pull-to-refresh o swipe-back, scroll-jacking, teclado que cubre los campos de entrada.
  9. Consistencia: lo mismo estilizado de dos maneras, estilos de iconos mezclados, radios de esquina o sombras que no coinciden.
  10. Texto y microtexto: botones vagos ("Enviar"), jerga, mensajes de error que culpan al usuario.
  11. Accesibilidad: etiquetas, orden de enfoque, alternativa de movimiento reducido, roles de lector de pantalla.
  12. Localización / RTL: diseño reflejado, dirección de deslizamientos y desplazamientos, iconos que deberían invertirse, alineación mixta de árabe e inglés.
  13. Flujo y arquitectura de la información: cuántos pasos para completar la tarea, si el siguiente paso es obvio, si las etiquetas y grupos de menú son lo que un usuario esperaría, puntos muertos, camino de regreso, demasiadas opciones en una pantalla (Ley de Hick), incorporación que bloquea en lugar de guiar. Necesita 2 o más pantallas o un recorrido descrito. Con una sola pantalla, juzga solo lo que implica (puntos de entrada, salidas, indicadores de progreso).
  14. Estilo y lenguaje visual: ¿el aspecto se mantiene unido como un sistema (radio, sombra, desenfoque, degradado, estilo de ilustración e icono, calidad de imagen)?, ¿encaja con el producto y su nivel de confianza (una aplicación de salud o pagos debe sentirse tranquila y creíble, no ruidosa)?, ¿el efecto está haciendo un trabajo o solo decorando (vidrio, brillo, degradados)?, ¿se ve anticuado o como una plantilla predeterminada?
  15. Convenciones de plataforma y capacidad de respuesta: el gesto de retroceso y la navegación coinciden con la plataforma (iOS HIG, Material), las hojas, barras de pestañas y diálogos se comportan como los usuarios esperan, se respetan las áreas seguras y el notch, el modo oscuro funciona, el diseño sobrevive en teléfonos pequeños, texto grande, tabletas y puntos de interrupción web o de paisaje si es relevante.

Contexto del proyecto: si el directorio de trabajo tiene un CLAUDE.md o AGENTS.md con reglas de IU (colores de un tema compartido, useRFLayout para RTL, componentes de hoja inferior, 5 estados para desplazamiento infinito), verifica también esas reglas y cítalas.

Verificación de animación (para la perspectiva de Sensación)

Una imagen fija no tiene tiempo. Para juzgar hover, transiciones y easing, obtén uno de estos, mejor primero:

  1. Código. Lee el código de transición o animación: CSS transition / @keyframes, Framer Motion, Reanimated (withTiming, withSpring, withDecay), Animated. Verifica duración, easing, qué propiedad se anima (transform y opacity vs. ancho, alto, top), escalonamiento, capacidad de interrupción, alternativa de movimiento reducido.
  2. Aplicación web en ejecución. Usa la herramienta de navegador disponible (navegador integrado o Claude en Chrome). Pasa el cursor o haz clic en el elemento y toma una captura de pantalla antes, durante (justo después del desencadenante) y después. Lee los valores reales con JS: getComputedStyle(el).transition y el.getAnimations(). Verifica los estados hover, focus, presionado y deshabilitado, no solo el predeterminado.
  3. Grabación de pantalla en fotogramas. Lee el video como imágenes; el lector de archivos no puede reproducir video.
    • Verifica which ffmpeg. Recorta al momento que importa, luego muestra los fotogramas en una nueva carpeta vacía: ffmpeg -ss <inicio> -t <segundos> -i <video> -vf "fps=20,scale=480:-1" <directorio_salida>/%03d.png. Usa fps 20 a 30 para transiciones de 200 a 300 ms, 10 para escenas lentas.
    • Para una visión general, haz una hoja de contacto: ffmpeg -i <video> -vf "fps=10,scale=240:-1,tile=6x4" <directorio_salida>/sheet.png, luego lee los fotogramas alrededor del cambio.
    • Graba Android con adb shell screenrecord --time-limit 8 /sdcard/m.mp4 y luego adb pull. Graba el simulador de iOS con xcrun simctl io booted recordVideo m.mov. Verifica which adb primero; puede estar en platform-tools del SDK de Android.
  4. La descripción del usuario. Último recurso. Pregunta qué ven al principio, en medio y al final de la animación.

Lo que los fotogramas pueden decir: si existe un estado o retroalimentación, orden de eventos, duración aproximada (número de fotogramas por intervalo de fotogramas), cambio de diseño, un fotograma donde el contenido desaparece (el parpadeo), rebasamiento, si el resaltado se mueve o solo salta. Lo que los fotogramas no pueden decir: la curva de easing exacta, tirones, sensación de resorte. Dilo y señala el código para esas.

Etiquetas de evidencia: termina cada crítica de Sensación "Por qué" con de dónde vino: (del código), (de fotogramas, resolución aproximada de 50 ms) o (de estilos calculados). Di "aproximadamente" para cualquier duración leída de fotogramas. Nunca presentes un número adivinado como medido.

Si ninguno de 1 a 4 está disponible, marca Sensación – en la línea de Perspectivas y pide uno de ellos.

Reglas de la crítica

  • Critica el diseño, nunca a la persona. Sin bromas sobre el autor, el equipo o el gusto del usuario. La pantalla es el objetivo.
  • Cada broma lleva un hallazgo. Si no puedes decir qué está mal y por qué, elimina la broma.
  • Gracioso en una línea, serio en la siguiente. Primero la línea de crítica (máx. ~20 palabras), luego la razón clara con el nombre del principio.
  • Sé específico. Señala el elemento ("el texto gris de 11 px debajo del precio"), no "la tipografía".
  • Honesto, no cruel. Si algo es bueno, dilo una vez en una sola línea al principio. No inventes elogios.
  • Sin gravedad falsa. Etiqueta cada uno: Bloqueante (los usuarios fallan o se lastiman), Molesto (los usuarios tienen dificultades), Pulido (los usuarios lo sienten).
  • Equilibra las perspectivas. No llenes los 5 espacios solo con detalles de IU. Si existe un problema de Flujo o Estilo, compite por impacto con el resto. Di qué perspectivas no pudiste juzgar en lugar de omitirlas en silencio.
  • El estilo es opinión, así que argumenta desde el producto. Vincula cada crítica de Estilo a la audiencia del producto, nivel de confianza o una inconsistencia dentro de la aplicación. Nunca "No me gustan los degradados".
  • Ten en cuenta la pila del usuario al escribir prompts de corrección (React Native, web, SwiftUI). Usa sus términos si se conocen, neutrales en caso contrario.
  • Tono: seco, rápido, no agresivo. Sin groserías, sin memes que necesiten explicación.

Formato de salida

Veredicto: <una línea, divertida, honesta>
Bueno: <una línea, fortaleza real>
Perspectivas: IU ✓ · UX ✓ · Sensación ✓ · Estilo ✓ (marca – con una razón breve para cualquier perspectiva que no pudiste juzgar, p. ej. "Sensación – imagen fija")

1. [Bloqueante|Molesto|Pulido] [IU|UX|Sensación|Estilo] <Línea de crítica>
   Por qué: <qué está mal, nombre del principio, una oración>
   Prompt de corrección: "<1 a 3 oraciones, vocabulario de diseño, listo para pegar>"

2. ...

También detectado: <lista separada por comas, solo si hay más de 5>

Prompt de corrección combinado:
"<un párrafo que fusiona las correcciones principales en el orden en que el usuario las experimenta: primero mirada, toque, liberación, reposo>"

Siguiente: <una cosa para hacer en menos de 2 minutos, p. ej. "pega el prompt combinado en una nueva sesión">

Ejemplo

Entrada: captura de pantalla de una pantalla de reserva. Botón "Confirmar" gris, texto gris de 12 px debajo de un gran banner de foto de archivo, un spinner sobre un fondo blanco mientras carga, hoja inferior aparece instantáneamente.

Salida:

Veredicto: Una pantalla de reserva que esconde lo único que viniste a hacer.
Bueno: El espaciado entre las tarjetas de sesión es consistente y transpira.
Perspectivas: IU ✓ · UX ✓ · Sensación ✓ (del código) · Estilo ✓ — Flujo no juzgado, solo una pantalla

1. [Bloqueante] [IU] El botón Confirmar está vestido como un botón deshabilitado y se esfuerza mucho por pasar desapercibido.
   Por qué: Jerarquía visual débil y sin capacidad de respuesta. Gris sobre gris falla el contraste y la acción principal no parece tocable.
   Prompt de corrección: "Haz que Confirmar sea la única acción principal: color de marca relleno del tema compartido, etiqueta blanca con contraste 4.5:1 o mejor, fijo en la parte inferior con un objetivo de 48 dp. Añade un estado presionado (escala a aproximadamente 0.96, 100 ms ease-out) y un haptic ligero. Deshabilítalo con un estilo claro solo mientras se ejecuta la solicitud."

2. [Molesto] [UX] Un spinner solitario en una página en blanco, como esperar en un aeropuerto vacío.
   Por qué: Sin esqueleto, por lo que el diseño salta cuando llegan los datos (cambio de diseño) y la percepción de rendimiento se resiente.
   Prompt de corrección: "Reemplaza el spinner con filas de esqueleto con un brillo, del tamaño de las tarjetas finales para que no se mueva nada. Transiciona cada esqueleto a su tarjeta con un escalonamiento de aproximadamente 50 ms."

3. [Molesto] [Sensación] La hoja inferior se teletransporta como si tuviera un lugar mejor al que ir.
   Por qué: Montaje instantáneo sin transición y sin posibilidad de descartar arrastrando, por lo que se siente barato y desconectado del tacto.
   Prompt de corrección: "Presenta la hoja con un resorte (sin rebasamiento) deslizándose hacia arriba desde abajo durante unos 300 ms, con un velo que aparece al mismo tiempo. Permite que el usuario la arrastre hacia abajo para descartarla, con impulso desde la velocidad de liberación y efecto de goma en la parte superior. Salida con ease-in más rápido."

4. [Pulido] [Estilo] El banner es una foto de archivo de un extraño sonriente en una pantalla sobre reservar un médico.
   Por qué: Las imágenes genéricas debilitan la confianza en un producto de salud y chocan con los iconos planos y tranquilos utilizados en otras partes de la pantalla (inconsistencia del lenguaje visual).
   Prompt de corrección: "Reemplaza la foto de archivo con el estilo de ilustración propio de la aplicación o un tinte sólido tranquilo con el mismo radio de esquina que las tarjetas, para que el encabezado coincida con el conjunto de iconos y se lea como creíble en lugar de genérico."

5. [Pulido] [IU] El texto gris de 12 px debajo del banner está susurrando el precio.
   Por qué: Texto pequeño de bajo contraste, sin escala para tipo dinámico, el precio es la información clave pero tiene la jerarquía más baja.
   Prompt de corrección: "Promociona el precio a un estilo de cuerpo grande en negrita junto al título, mantén el texto a un mínimo de 14 px con contraste 4.5:1, y deja que ambos escalen con el tamaño de fuente del sistema."

Prompt de corrección combinado:
"En la carga inicial, muestra tarjetas de esqueleto con un brillo del tamaño del diseño final, luego transiciona al contenido con un escalonamiento de 50 ms y sin cambio de diseño. Reemplaza la foto de archivo con el estilo de ilustración de la aplicación o un tinte tranquilo usando el radio de esquina de la tarjeta. Haz que el precio sea negrita y prominente, el texto al menos 14 px con contraste 4.5:1. Haz que Confirmar sea la acción principal rellena, fija en la parte inferior con un objetivo de 48 dp, una escala de presión de 0.96 y un haptic ligero. La hoja inferior sube con un resorte en unos 300 ms con un velo que se desvanece, se puede arrastrar hacia abajo para descartar con impulso de liberación y efecto de goma, y sale más rápido con ease-in."

Siguiente: pega el prompt combinado en una nueva sesión, o ejecuta `/design-prompt-rewriter` en cualquier corrección individual para ajustarla.

Cuando la entrada es escasa

  • ¿Solo una descripción vaga ("mi aplicación se siente mal")? Pide una cosa: una captura de pantalla o la ruta del archivo de la pantalla. No critiques a ciegas.
  • ¿La animación no se puede juzgar a partir de una imagen fija? Dilo en una línea, pide el código de animación, una grabación de pantalla o una aplicación en ejecución (consulta Verificación de animación), luego critica lo que puedas ver.
  • ¿Solo una pantalla? Juzga IU, estados de UX, Sensación (si existe código o grabación) y Estilo. Marca Flujo como no juzgado y ofrece revisar el recorrido si comparten las siguientes pantallas o describen los pasos.
  • ¿Múltiples pantallas? Haz primero un pase de flujo (pasos, etiquetas, puntos muertos, camino de regreso), luego critica la peor pantalla y di cuál elegiste.

Individual skills in this repo

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

Skills relacionados