Communitygithub.com

psicología-ux

Aplica psicología UX probada y guías de plataforma (Apple HIG, Google Material, heurísticas de Nielsen Norman, WCAG) al diseñar, construir o revisar cualquier pantalla o flujo de una app o sitio web, y rechaza los patrones oscuros. Úsalo siempre que el trabajo involucre una pantalla o flujo orientado al usuario (formularios, onboarding, registro o inicio de sesión, muros de pago, avisos de mejora, precios, proceso de compra, estados vacíos, mensajes de error, estados de carga, configuraciones, avisos de permisos o notificaciones, cancelación, paneles de control), y siempre que el usuario pida mejorar la experiencia.

¿Qué es psicología-ux?

Esta habilidad transforma principios de psicología UX y pautas de plataforma en decisiones de diseño concretas. Su núcleo ético sostiene que la persuasión debe ayudar al usuario, no engañarlo: rechaza explícitamente los patrones oscuros como falsas cuentas atrás, escasez ficticia o confirmación vergonzante. Funciona en dos modos: **modo diseño**, donde al construir una pantalla aplica los principios y explica brevemente cuáles usó; y **modo revisión**, donde analiza capturas, maquetas o código para generar hallazgos priorizados por impacto. El flujo de trabajo sigue un orden estricto: primero eliminar la fricción (claridad, facilidad, confianza), luego aplicar principios con evidencia sólida (como valores predeterminados inteligentes, ley de Hick, progreso dotado), verificar la ética, comprobar las convenciones de plataforma (Apple HIG, Material Design, WCAG) y proponer una métrica para medir el cambio. La habilidad incluye guías detalladas para escribir texto de interfaz (verbos en botones, errores descriptivos, precios claros) y una lista de 'cosas a evitar' como gamificación no solicitada, valores predeterminados que cuesten dinero o rediseños que rompan convenciones. Está diseñada para asistentes de IA como Claude Code, Cursor o Codex, y su documentación de referencia cubre ética, listas de verificación por tipo de pantalla y principios completos con ejemplos y nivel de evidencia.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/markvictorpro/ux-psychology/tree/HEAD/skills/ux-psychology

Preguntar en tu IA favorita

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

Documentación

Psicología UX

Las personas no leen las pantallas con atención ni deciden de forma lógica. Ojean, siguen valores predeterminados, evitan el esfuerzo y juzgan por el contexto. Esta habilidad convierte eso en decisiones de diseño concretas, y mantiene una línea: la persuasión también tiene que ayudar al usuario. Nunca construye trucos que funcionen en contra de la persona que usa la aplicación.

Dos modos

  • Modo diseño: el usuario está construyendo o modificando una pantalla. Aplica los principios mientras construyes. No des lecciones; entrega la pantalla mejorada y luego enumera los principios que usaste en dos a cinco líneas cortas.
  • Modo revisión: el usuario comparte una captura de pantalla, maqueta, URL o código de UI y pregunta qué está mal o cómo mejorarlo. Produce hallazgos ordenados por prioridad (formato más abajo).

Si no está claro cuál se quiere, mira la solicitud: "construye / haz / agrega" significa diseño; "revisa / evalúa / por qué la gente no…" significa revisión.

Cuando el usuario pregunta sobre un enfoque sin una pantalla que mirar ("¿Deberíamos añadir insignias?", "¿Por qué la gente abandona en el paso 3?"), responde la pregunta en la primera oración, luego da las razones y soluciones en el formato de revisión. Indica qué puntos son observaciones y cuáles son hipótesis para verificar.

Datos faltantes. El diseño honesto necesita hechos reales: el precio real, qué sucede realmente cuando el almacenamiento está lleno, el número real de usuarios. Si no los tienes, no los inventes. Usa marcadores de posición claramente indicados ({{precio_por_mes}}) o declara la suposición en una línea ("Asume que las notas nuevas dejan de sincronizarse cuando el almacenamiento está lleno; verifica esto"). Cuando solo se solicita marcado, marca dónde aún debe implementarse el comportamiento real (validación, guardado, compra).

Flujo de trabajo

1. Lee primero el contexto

Determina esto a partir del código, la captura de pantalla o la conversación antes de sugerir algo. Pregunta solo si no puedes deducirlo y la respuesta cambia el consejo.

  • Tipo de producto. Aplicación de consumo, herramienta profesional o dominio de alta confianza (salud, médico, finanzas, legal, infantil, personas mayores). Las herramientas profesionales necesitan velocidad, densidad y prevención de errores, no persuasión. Los dominios de alta confianza siguen las reglas estrictas de references/ethics.md.
  • Plataforma. iOS, iPadOS, Android, web, Windows o macOS de escritorio. Cada una tiene convenciones que la gente ya conoce (consulta references/platforms.md).
  • Tipo de pantalla. Formulario, onboarding, registro, muro de pago, precios, proceso de compra, estado vacío, error, carga, configuración, acción destructiva, aviso de permiso, cancelación, panel de control.
  • El objetivo del usuario en esta pantalla en una oración, y el objetivo del negocio en una oración. Un buen diseño sirve a ambos. Cuando entran en conflicto, gana el objetivo del usuario.

2. Corrige la fricción antes de añadir persuasión

El orden importa. Una pantalla que la gente no puede usar no se salvará con un encuadre ingenioso. Sigue este orden:

  1. ¿Pueden hacerlo? Claridad, texto legible, siguiente paso obvio, objetivos suficientemente grandes, sin errores, respuesta rápida, accesible.
  2. ¿Es fácil? Menos decisiones, valores predeterminados inteligentes, menos campos, reconocimiento en lugar de recuerdo, divulgación progresiva.
  3. ¿Confían en ello? Valor antes de pedir, precios honestos, consecuencias claras, prueba social real, privacidad explicada.
  4. ¿Quieren continuar? Progreso real mostrado, inversión, finales buenos, avisos oportunos y honestos.

3. Ejecuta la lista de verificación para el tipo de pantalla

Abre references/screen-checklists.md y usa la sección para esta pantalla. Enumera qué verificar y los errores habituales.

4. Elige principios que encajen

Usa references/principles.md para el catálogo completo: qué es cada principio, cómo aplicarlo, un ejemplo, cómo se usa mal y qué tan sólida es la evidencia. Prefiere principios con evidencia sólida. No apliques un principio solo porque existe; tres que encajen mejor que diez forzados.

Los que aparecen con más frecuencia:

SituaciónRecurre a
Demasiados campos u opcionesValores predeterminados inteligentes, ley de Hick, divulgación progresiva, fragmentación
La gente abandona un flujo de varios pasosProgreso dotado, gradiente de meta, pasos etiquetados, guardar trabajo parcial
La gente no se registraValor antes del registro, efecto IKEA, creación de cuenta diferida
La gente ignora una mejora o aviso importanteApuesta honesta (encuadre de pérdida), oportunidad, especificidad
Un precio parece caroPrecio en contexto, anclaje, encuadre por período
La gente no encuentra la acción principalUna acción principal, efecto Von Restorff, ley de Fitts, ley de Jakob
Se siente lentoUmbral de Doherty, UI optimista, pantallas esqueleto, ilusión de trabajo
La gente comete erroresPrevención de errores, restricciones, deshacer, validación en línea
La gente olvida dónde estabaReconocimiento sobre recuerdo, estado visible, recordatorios de Zeigarnik
La experiencia termina malRegla del pico-fin: haz que el último paso y el momento de éxito sean buenos

5. Pasa la puerta ética

Antes de entregar, verifica cada elemento persuasivo contra references/ethics.md. Si el usuario pide un patrón oscuro (cuenta atrás falsa, escasez ficticia, confirmación vergonzante, complementos de pago preseleccionados, flujos difíciles de cancelar, reseñas falsas, progreso falso, insistencia molesta), no lo construyas. Di en una o dos oraciones por qué resulta contraproducente (confianza, rechazo de la tienda de aplicaciones, riesgo legal), luego construye la versión honesta que persigue el mismo objetivo. No moralices más allá de eso.

6. Verifica las reglas de la plataforma

Confirma objetivos, navegación, alertas, permisos y accesibilidad contra references/platforms.md para la plataforma en cuestión. Las convenciones de plataforma superan a la novedad: la gente ya sabe cómo funciona su teléfono.

7. Di cómo medirlo

Termina el diseño o la revisión con una forma de saber si el cambio funcionó, por ejemplo, tasa de finalización del formulario, tiempo hasta la primera acción clave, tasa de registro después del resultado gratuito, retención a 7 días, tickets de soporte sobre el error. Usa las categorías HEART de Google (felicidad, engagement, adopción, retención, éxito de tarea) cuando el usuario quiera un plan más completo.

Salida del modo revisión

Ordena los hallazgos por impacto en el usuario, del más importante al primero. Para cada uno:

1. [Alto | Medio | Bajo] Título corto
   Qué está mal: una o dos oraciones sobre lo que experimenta el usuario.
   Principio: nombre (una línea sobre por qué importa aquí).
   Solución: el cambio concreto, con texto copia cuando la redacción sea la solución.

Después de los hallazgos, añade "Lo que ya funciona" con hasta tres cosas que conservar, para que las partes buenas no se eliminen por accidente. Si la pantalla contiene un patrón oscuro, enuméralo primero como Alto, sin importar qué más esté mal.

Limítate a los hallazgos que importan (normalmente de 3 a 8). Una lista larga de críticas menores oculta las importantes.

Salida del modo diseño

Construye la pantalla. Luego una nota breve:

Principios usados:
- Valores predeterminados inteligentes: fechas preestablecidas para este fin de semana, huéspedes para 2 adultos.
- Una acción principal: "Mostrar 12 habitaciones" es el único botón relleno.
Medida: tasa de finalización de búsqueda antes vs. después.

Escribir texto de interfaz

El texto es parte del diseño, a menudo la parte más importante.

  • Di lo que sucede, no lo que es el botón: "Mostrar 12 habitaciones", no "Enviar".
  • Los botones de acción empiezan con un verbo. Las declinaciones son la excepción y se mantienen neutrales: "Ahora no", "Cancelar", "No, gracias", nunca "No, prefiero seguir desorganizado".
  • Los errores dicen qué salió mal, dónde y cómo solucionarlo, en palabras del usuario: "Usa al menos 8 caracteres (tienes 6)".
  • Los precios indican el monto completo y el período: "$2.99 al mes, cancela en cualquier momento en Configuración".
  • Palabras sencillas en lugar de jerga. Oraciones cortas. Minúsculas salvo en nombres propios.

Cosas a evitar incluso cuando parecen útiles

  • Añadir persuasión a herramientas profesionales o clínicas donde los usuarios necesitan velocidad y precisión. Un dentista registrando dientes no necesita rachas.
  • Preseleccionar cualquier cosa que cueste dinero, comparta datos o suscriba a marketing. Los valores predeterminados son para beneficio del usuario, no del negocio. Las preferencias editables (fechas, tamaño del grupo, un plan recomendado resaltado en una página de precios) están bien; un cargo o consentimiento preseleccionado no.
  • Rellenar previamente hallazgos clínicos, diagnósticos o cifras financieras de hábitos pasados. Los valores predeterminados en herramientas profesionales cubren configuraciones y diseño, nunca los hechos que se registran.
  • Gamificación (puntos, rachas, insignias) a menos que el usuario lo haya pedido y respalde un objetivo que la persona realmente tenga.
  • Afirmar números que no tienes ("10,000 usuarios felices"). Usa datos reales o déjalos fuera.
  • Rediseñar cosas que siguen las convenciones de plataforma solo para que se vean diferentes.

Skills relacionados