Communitygithub.com

check-user-experience

Audita la interfaz de un proyecto contra las 30 Leyes de UX (lawsofux.com) y genera un informe priorizado con problemas reales y soluciones concretas.

¿Qué es check-user-experience?

Esta habilidad permite auditar la experiencia de usuario de cualquier interfaz (web, aplicaciones móviles, componentes aislados) aplicando las 30 Leyes de UX de lawsofux.com (Fitts, Hick, Jakob, Miller, Doherty, Postel, Tesler, Von Restorff, Peak-End, Serial Position, Zeigarnik, Goal-Gradient, Gestalt, carga cognitiva, sobrecarga de opciones, fragmentación, navaja de Occam, Pareto, Parkinson, usabilidad-estética, modelos mentales, flujo, atención selectiva, memoria de trabajo, paradoja del usuario activo y sesgo cognitivo). Funciona analizando el código fuente (detectando el stack: React, Vue, Svelte, Angular, React Native, Flutter, SwiftUI), URLs en vivo (abriendo el navegador, midiendo tiempos de respuesta y objetivos táctiles) o capturas de pantalla. Para cada ley, busca señales concretas (como objetivos táctiles pequeños para Fitts, listas largas sin filtro para Hick, falta de feedback para Doherty) y reporta solo hallazgos verificables con ubicación exacta (archivo:línea, elemento CSS, región en screenshot) y una sugerencia de corrección práctica. El informe se estructura por severidad (Alta, Media, Baja) y muestra una puntuación sobre 30 leyes. No modifica el código a menos que el usuario lo solicite después del informe. Es útil para desarrolladores, diseñadores y equipos de producto que buscan una revisión rápida y basada en principios de UX sin necesidad de una auditoría completa de accesibilidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aswin-haridas/skills/tree/HEAD/skills/check-user-experience

Preguntar en tu IA favorita

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

Documentación

Verificar Experiencia de Usuario

Audita una interfaz contra las Leyes de UX y produce un informe priorizado de problemas reales con soluciones concretas. Informa, no arregles, a menos que el usuario lo solicite.

Flujo de Trabajo

1. Recopilar la superficie

  • Código base: detecta el stack, luego encuentra pantallas/rutas, componentes compartidos (botones, inputs, formularios, navegación, modales, listas, tablas), tokens de diseño y estados de carga/error. Lee el marcado y los estilos reales, no solo los nombres de archivo.
  • URL en vivo / compilación local: ábrelo en el navegador, recorre los flujos principales, toma capturas de pantalla en anchos de escritorio y móvil, mide los objetivos táctiles y los tiempos de respuesta cuando sea posible.
  • Captura de pantalla: juzga visualmente; marca las comprobaciones solo de código como "no verificable".
  • Identifica las 3–5 tareas principales del usuario (registro, búsqueda, compra, crear X). Audita esos flujos con mayor énfasis — el principio de Pareto se aplica también a la auditoría.

2. Revisar cada ley

Revisa la tabla a continuación. Para cada ley, busca las señales enumeradas. Solo reporta hallazgos concretos con una ubicación; nunca rellenes el informe con consejos genéricos. Si una ley se cumple, pasa a la lista de "aprobadas" en una línea.

3. Informar (formato abajo), luego ofrecer arreglar los elementos de Alta severidad.

Las leyes: qué buscar y cómo solucionar

Interacción y esfuerzo

LeySeñalar cuandoSolución sugerida
Ley de Fitts — el tiempo para alcanzar un objetivo depende del tamaño y la distanciaObjetivos táctiles < 44×44 pt (iOS) / 48×48 dp (Android) / 24×24 CSS px mínimo (WCAG 2.5.8), idealmente 44px; botones solo con icono con padding pequeño; acción principal lejos de donde está el ojo/pulgar; botones destructivos y principales adyacentes con < 8px de espacioAumenta el padding o añade ::after { inset:-8px } área de impacto; coloca la CTA principal cerca del contenido sobre el que actúa, en la zona del pulgar en móvil; separa las acciones destructivas
Ley de Hick — el tiempo de decisión crece con el número/complejidad de las opcionesNavegación con > 7 elementos de nivel superior; menús/selects con listas largas sin ordenar; muchas CTA de igual peso en una misma pantallaAgrupa, divulga progresivamente ("Más"), añade búsqueda/filtro a listas largas, valores predeterminados sensatos, una CTA principal
Sobrecarga de OpcionesPáginas de precios/planes con > 3–4 opciones y sin recomendación; paneles de configuración con muchos ajustes visibles a la vezDestaca una opción recomendada, colapsa opciones avanzadas, tabla comparativa
Umbral de Doherty — la productividad se dispara cuando la respuesta es < 400 msSin estado de carga/pendiente en acciones asíncronas; botones que no se desactivan o muestran progreso al enviar; spinners de página completa para cargas pequeñas; sin actualizaciones optimistas; llamadas de red bloqueantes en la entradaRetroalimentación inmediata < 100 ms, esqueletos, UI optimista, spinners retrasados (~300 ms), búsqueda con debounce
Ley de Postel — sé liberal en lo que aceptasFormatos de entrada estrictos (teléfono, fechas, números de tarjeta que rechazan espacios/guiones); correos electrónicos sensibles a mayúsculas; sin recorte; errores de validación que no dicen cómo solucionar; pegado bloqueadoNormaliza la entrada (recorta, elimina separadores), acepta múltiples formatos, atributos inputmode/autocomplete, mensajes de error útiles
Ley de Tesler — la complejidad no se puede eliminar, solo moverEl usuario se ve obligado a hacer lo que el sistema podría (volver a ingresar datos conocidos, calcular valores, elegir zona horaria/país que podrían inferirse)Autocompletar, valores predeterminados inteligentes, inferencia, recordar últimas elecciones
Paradoja del Usuario Activo — los usuarios no leen manualesFunciones solo descubribles a través de documentación/información sobre herramientas al pasar el ratón; largos tutoriales de incorporación antes de mostrar valor; estados vacíos sin orientaciónSugerencias en línea en el punto de uso, estados vacíos procesables, incorporación aprendiendo haciendo
FlujoInterrupciones innecesarias (modales, confirmaciones para acciones reversibles, re-autenticación forzada); sin atajos de teclado para rutas de poder; pérdida de foco después de accionesDeshacer en lugar de confirmar, preservar el foco/desplazamiento, soporte de teclado, minimizar cambios de contexto

Memoria y cognición

LeySeñalar cuandoSolución sugerida
Ley de Miller / FragmentaciónFormularios largos sin interrupción; cadenas largas mostradas en bruto (IDs, teléfonos, números de tarjeta sin formato); muros de texto; navegación con 10+ elementos planosDivide los formularios en grupos/pasos, formatea los números en fragmentos, encabezados y párrafos cortos
Carga CognitivaPantallas densas con elementos en competencia; jerga; terminología inconsistente para lo mismo; desorden decorativoElimina elementos no esenciales, etiquetas consistentes, lenguaje sencillo
Memoria de TrabajoEl usuario debe recordar información de una pantalla anterior (códigos, elecciones anteriores); etiquetas solo en marcadores de posición que desaparecen al escribir; comparaciones entre páginasMantén el contexto visible (resúmenes, etiquetas persistentes, migas de pan), comparación lado a lado
Modelo MentalControles que se comportan diferente a su apariencia (enlace con estilo de botón que navega o viceversa); metáforas inusuales; modelo de guardado poco claro (autoguardado vs manual)Coincide con la expectativa del usuario; haz explícito el estado del sistema
Ley de Jakob — los usuarios esperan que tu sitio funcione como otrosColocación no estándar (el logo no enlaza al inicio, el carrito no está en la parte superior derecha, búsqueda oculta); controles personalizados que reemplazan a los nativos sin paridad; patrones reinventadosSigue las convenciones de la plataforma (HIG / Material / normas web); elementos nativos primero
Navaja de OccamPasos redundantes, controles duplicados, funciones que ningún flujo necesita en la pantalla principalElimina o mueve a superficies secundarias
Principio de ParetoTareas principales enterradas mientras que las funciones de uso poco frecuente ocupan un espacio privilegiadoPromueve el 20% de las funciones que se usan el 80% del tiempo
Ley de ParkinsonFormularios/tareas que toman más tiempo del necesario; sin autocompletar; sin indicadores de progreso que establezcan expectativasAutocompletar, atributos de autocompletado, muestra tiempo/pasos estimados
Atención Selectiva / Ceguera a BannersInformación crítica con estilo de anuncio o colocada en banners/barras laterales; advertencias importantes que se mezclanColoca la información clave en línea dentro de la ruta de la tarea, distinta pero no parecida a un anuncio
Sesgo CognitivoPatrones oscuros: suscripciones pre-marcadas, confirmaciones vergonzosas, costos ocultos, urgencia falsa, valores predeterminados engañososElimina; valores predeterminados honestos. Señalar como Alta (riesgo ético + legal)

Percepción (Gestalt)

LeySeñalar cuandoSolución sugerida
Ley de ProximidadEtiquetas más cercanas al input incorrecto; espacio igual entre elementos no relacionados y relacionados; texto de ayuda lejos de su campoEspaciado más ajustado dentro de los grupos, más grande entre grupos (escala de espaciado)
Ley de SimilitudElementos con el mismo aspecto que se comportan de manera diferente (texto cliqueable y estático idéntico); estilos de botón inconsistentes para el mismo nivel de acciónLenguaje visual consistente por rol
Ley de Región ComúnControles relacionados no agrupados; tarjetas sin límites que mezclan contenidoTarjetas, secciones, regiones de fondo para grupos
Ley de Conexión UniformePasos/elementos relacionados no vinculados visualmenteLíneas, conectores, contenedores compartidos para steppers/timelines
Ley de PrägnanzIconos/ilustraciones excesivamente complejos, formas ambiguasSimplifica las formas; iconos reconocibles con etiquetas
Efecto de Usabilidad EstéticaInconsistencia visual (radios mixtos, colores aleatorios, cuadrícula desalineada, escala tipográfica inconsistente) que erosiona la confianzaTokeniza el espaciado/tipo/color; alinea a una cuadrícula

Secuencia, motivación y memoria de la experiencia

LeySeñalar cuandoSolución sugerida
Efecto Von RestorffCTA principal no visualmente distinta; todo resaltado para que nada destaque; dependencia solo del colorUna acción principal enfatizada por vista; usa también forma/tamaño/icono (accesibilidad)
Efecto de Posición SerialElementos de navegación clave en medio de listas largas; información más importante enterrada en medio de la páginaColoca los elementos clave al principio y al final (por ejemplo, Inicio primero, Perfil/Carrito al final en la barra de pestañas)
Regla del Pico-FinEstados de éxito débiles o ausentes (el envío del formulario termina con nada o una redirección simple); puntos muertos de error severos; finales de flujo abruptosConfirmación clara y satisfactoria; recuperación útil en errores; pule el paso final
Efecto de Gradiente de MetaFlujos de múltiples pasos sin indicación de progreso; progreso que comienza en 0Stepper/barra de progreso, muestra los pasos restantes, da una ventaja inicial
Efecto ZeigarnikTareas incompletas olvidadas (sin borradores, datos de formulario perdidos al navegar, sin recordatorios de finalización de perfil)Autoguardar borradores, "continuar donde lo dejaste", listas de verificación de finalización

Severidad

  • Alta — bloquea o ralentiza seriamente una tarea principal, causa errores/pérdida de datos, fallo de accesibilidad o un patrón oscuro.
  • Media — fricción o confusión notable en un camino común.
  • Baja — pulido; pantallas secundarias.

Formato del informe

# Auditoría UX — <app/pantalla>
Alcance: <lo que se auditó> · Método: código / en vivo / captura
Puntuación: <leyes aprobadas>/30 · Alta: n · Media: n · Baja: n

## Principales 3 para arreglar primero
1. ...

## Hallazgos
### [Alta] Ley de Fitts — Botones de icono demasiado pequeños
Dónde: src/components/Toolbar.tsx:42 (también Header.tsx:18)
Problema: Botones de icono de 20×20 px sin padding; toques erróneos en móvil.
Solución: añade `p-3` (objetivo de 44px) o una extensión de área de impacto `::after`.
```(fragmento de código si es corto)```

(...un bloque por hallazgo, agrupado por severidad, Alta primero…)

## Aprobadas
- Ley de Jakob — navegación estándar y patrón de logo-inicio.
- ...

## No verificable
- Umbral de Doherty — necesita una aplicación en ejecución para medir tiempos de respuesta.

Reglas

  • Cada hallazgo necesita una ley, una ubicación (archivo:línea, URL + elemento o región de captura de pantalla), el problema observado y una solución específica. Sin ubicación → no lo reportes.
  • Fusiona duplicados: un hallazgo por causa raíz, enumerando todas las ubicaciones.
  • No cambies el estilo ni la personalidad de la aplicación en las soluciones; sugiere el cambio más pequeño que resuelva el problema.
  • Respeta las convenciones de la plataforma (iOS HIG, Material, web) al juzgar la Ley de Jakob y los tamaños de objetivo.
  • La superposición con accesibilidad (contraste, foco, etiquetas) está bien — anótala bajo la ley relevante, pero no conviertas esto en una auditoría WCAG completa.
  • Después del informe, pregunta si se deben arreglar los hallazgos de Alta (o todos). Si se encuentran problemas de movimiento/feedback (Doherty, Pico-Fin, Gradiente de Meta), menciona que /animate-this-app puede abordarlos.

Individual skills in this repo

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

Skills relacionados