Communitygithub.com

Nuclear-Marmalade/ux-psychology-skill

Capa asesora para decisiones de diseño web. Expone principios relevantes de psicología conductual durante el diseño de páginas y componentes. Esta es una **entrada ponderada**: informa decisiones, no anula el juicio estético, la identidad de marca ni la dirección creativa.

¿Qué es ux-psychology-skill?

Este skill de agente AI (compatible con Claude Code, Cursor y Codex) actúa como una capa consultiva de psicología UX para diseñadores web y desarrolladores. Al activarse, analiza el tipo de página (landing, pricing, onboarding, dashboard, checkout, etc.) y sugiere los 3-5 principios de psicología conductual más relevantes, como anclaje, aversión a la pérdida o carga cognitiva, ofreciendo recomendaciones concretas y aplicables directamente en código HTML, JSX o CSS. Su utilidad radica en que no impone cambios drásticos sino que pondera los principios frente a la identidad de marca, accesibilidad y requisitos técnicos, siguiendo una jerarquía clara donde el buen diseño y la confianza del usuario tienen prioridad. Incluye ejemplos de implementación a nivel de código (antes/después) para principios como anclaje en precios, finalización progresiva en formularios o aversión a la pérdida en CTAs. También documenta 65 principios agrupados en 11 categorías (atención, memoria, sesgos cognitivos, persuasión, ética, etc.), y advierte sobre anti-patrones oscuros como escasez falsa, shame-confirming o costos ocultos. Funciona mejor como capa de revisión posterior al diseño y se basa en fuentes académicas reconocidas (Kahneman, Norman, Cialdini, NN/g).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add Nuclear-Marmalade/ux-psychology-skill

Preguntar en tu IA favorita

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

Documentación

UX Psychology Skill

Capa asesora para decisiones de diseño web. Expone principios relevantes de psicología conductual durante el diseño de páginas y componentes. Esta es una entrada ponderada: informa decisiones, no anula el juicio estético, la identidad de marca ni la dirección creativa.

Cuándo Usarlo

Invoca después de construir o diseñar páginas, componentes o flujos. El skill funciona mejor como capa de revisión: primero construye, luego aplica el lente de psicología para encontrar lo que falta:

  • Páginas de aterrizaje, precios, flujos de incorporación
  • Embudos de suscripción/conversión
  • Diseños de paneles y presentación de datos
  • Navegación y arquitectura de información
  • Páginas de producto de e-commerce y flujos de pago
  • Cualquier página donde quieras que los usuarios realicen una acción específica

Proceso de Decisión

Cuando se active, sigue este orden:

  1. Identifica el tipo de página — landing, precios, incorporación, panel, checkout, etc.
  2. Extrae los 3-5 principios más relevantes de las prescripciones por tipo de página a continuación
  3. Para cada principio, indica: qué es → cómo aplicarlo a ESTA página específica → cómo se ve el anti-patrón
  4. Pondera frente a restricciones — la identidad de marca, accesibilidad y requisitos técnicos siempre tienen prioridad
  5. Recomienda cambios específicos e implementables — no consejos abstractos. Muestra qué cambiar en el marcado, diseño o copia. Si puedes señalar una línea de código, hazlo.

Cómo Ponderar

Los principios de psicología son una entrada entre muchas. La jerarquía de ponderación:

  1. Identidad de marca y visión creativa (la más alta — el sitio debe verse y sentirse bien)
  2. Accesibilidad y usabilidad (no negociable — cumplimiento WCAG, objetivos táctiles, contraste)
  3. Calidad técnica (rendimiento, SEO, diseño responsivo)
  4. Principios de psicología (este skill — influencia sutil, no manipulación agresiva)

Nunca sacrifiques estética o confianza del usuario por un truco psicológico. Si un principio entra en conflicto con un buen diseño, el buen diseño gana.

Qué NO es este Skill

  • NO es un manual de patrones oscuros — cada principio aquí es solo aplicación ética
  • NO es un sistema de diseño completo — aumenta las habilidades de diseño existentes
  • NO es un reemplazo para la investigación de usuarios — los datos reales de usuarios siempre superan la teoría
  • NO es una lista de verificación rígida — usa los principios que encajen, ignora los que no

Prescripciones por Tipo de Página (Incluidas)

Los principios principales por tipo de página, autocontenidos para consulta rápida. Consulta knowledge/page-prescriptions.md para orientación ampliada y errores comunes.

Página de Inicio / Landing

PrincipioAplicación
Primeras ImpresionesEl hero comunica valor en menos de 3 segundos. Se forma en 50ms — no hay segundas oportunidades.
AnclajeLidera con tu métrica o afirmación más fuerte. El primer número visto establece la referencia.
Prueba SocialNúmeros reales visibles desde el principio (usuarios, resultados, historial). Las afirmaciones vagas no convierten.
Olor a InformaciónNavegación clara — el usuario sabe exactamente a dónde ir después.
Estética-UsabilidadEl pulido visual genera confianza antes que el contenido. Lo bello se siente más fácil de usar.

Precios / Suscripción

PrincipioAplicación
AnclajeMuestra el nivel premium primero o el más prominente visualmente. Todo lo demás parece una ganga.
Aversión a la PérdidaEnmarca en torno a lo que los usuarios GRATUITOS PIERDEN, no solo lo que los usuarios de pago obtienen. Perder duele 2x más.
Efecto por DefectoPre-selecciona el nivel recomendado. La mayoría de usuarios nunca cambia los valores predeterminados.
Compromiso/ConsistenciaLos usuarios que ya usaron funciones gratuitas están preparados para suscribirse — cada paso lleva al siguiente.

Incorporación / Registro

PrincipioAplicación
Compromiso ProgresivoPrimero una acción gratuita pequeña, luego la cuenta, luego el pago.
Carga CognitivaUna pregunta por pantalla supera a un formulario largo. Elimina todo lo no esencial.
Efecto ZeigarnikMuestra el progreso (paso 2 de 4). Las tareas incompletas molestan — los usuarios vuelven para terminar.
ReciprocidadDa valor antes de pedir información. Acceso gratuito a herramientas, vista previa o resultado de muestra.

Panel / Visualización de Datos

PrincipioAplicación
FragmentaciónAgrupa los datos por categoría o prioridad — no una lista gigante.
Memoria EspacialDiseño consistente para que los usuarios recurrentes encuentren las cosas al instante. No muevas nada.
SatisfacciónResalta la única información más importante. Los usuarios eligen la primera opción aceptable.
Reconocimiento sobre RecuerdoMuestra el contexto completo (etiquetas, marcas de tiempo, iconos) — no obligues a los usuarios a recordar.

Checkout / Pago

PrincipioAplicación
Carga CognitivaOpción de pago como invitado. Campos de formulario mínimos. Una decisión a la vez.
TransparenciaMuestra TODOS los costos antes del paso de pago. Las tarifas sorpresa son la causa #1 de abandono.
Aversión a la PérdidaSellos de confianza y garantías JUNTO AL botón de pago, no en el pie de página.
Efecto por DefectoPre-selecciona el envío estándar. Pre-marca "guardar información". Reduce las decisiones.

Acerca de / Página de Confianza

PrincipioAplicación
AutoridadMetodología, fuentes de datos, experiencia del equipo — demuestra que sabes lo que haces.
Jerarquía de ConfianzaEsta página sirve a usuarios en nivel 2-3 (interés → confianza). No pidas la venta aquí.
TransparenciaHonesto sobre las limitaciones, no solo sobre las fortalezas. La vulnerabilidad genera confianza.

Ejemplos de Implementación a Nivel de Código

Anclaje (Página de Precios)

Antes — todos los niveles iguales, sin ancla:

<div class="planes">
  <div class="plan">Básico — $19/mes</div>
  <div class="plan">Pro — $49/mes</div>
  <div class="plan">Empresarial — $99/mes</div>
</div>

Después — Pro anclado como predeterminado visual:

<div class="planes">
  <div class="plan">Básico — $19/mes</div>
  <div class="plan destacado">        <!-- visualmente prominente, pre-seleccionado -->
    <span class="insignia">Más Popular</span>
    Pro — $49/mes
  </div>
  <div class="plan">Empresarial — $99/mes</div>
</div>

Por qué: El nivel destacado se convierte en el ancla. Básico parece una ganga en comparación. Empresarial existe para hacer que Pro parezca razonable. La insignia "Más Popular" añade prueba social.

Aversión a la Pérdida (CTA de Suscripción)

Antes — enmarcado en ganancia:

<button>Obtener Acceso Premium</button>
<p>Desbloquea todas las funciones y contenido premium.</p>

Después — enmarcado en pérdida:

<button>Mantener mi Acceso Premium</button>
<p>Sin Premium, perderás acceso a información diaria,
   paneles guardados y soporte prioritario.</p>

Por qué: "Perderás acceso" activa la aversión a la pérdida (~2x más fuerte que ganancias equivalentes). El CTA usa "Mantener" — enmarcándolo como proteger algo que ya tienen.

Efecto Zeigarnik (Progreso de Incorporación)

Antes — sin indicación de progreso:

<form>
  <h2>Cuéntanos sobre ti</h2>
  {/* 8 campos en una página */}
</form>

Después — escalonado con progreso visible:

<div className="barra-progreso">
  <div className="paso completado">Perfil</div>
  <div className="paso activo">Preferencias</div>   {/* actual */}
  <div className="paso">Revisión</div>
</div>
<form>
  <h2>Paso 2 de 3 — Tus Preferencias</h2>
  {/* Solo 2-3 campos */}
</form>

Por qué: Las barras de progreso incompletas crean tensión psicológica. Los usuarios regresan para terminar lo que comenzaron. Dividir 8 campos en 3 pasos de 2-3 campos reduce la carga cognitiva Y crea el tirón para completar.

Carga Cognitiva (Checkout)

Antes — creación de cuenta forzada:

<h2>Crear Cuenta para Continuar</h2>
<input placeholder="Correo electrónico" />
<input placeholder="Contraseña" />
<input placeholder="Confirmar Contraseña" />
<button>Crear Cuenta y Pagar</button>

Después — pago como invitado con creación de cuenta diferida:

<h2>Pagar</h2>
<input placeholder="Correo electrónico (para el recibo)" />
<button>Pagar Ahora</button>
<p class="sutil">¿Quieres guardar tu información para la próxima vez?
   <a href="/crear-cuenta">Crear una cuenta</a> después del pago.</p>

Por qué: Cada campo adicional es un punto de decisión que causa abandono. Consigue la venta primero. La creación de cuenta es una pequeña solicitud DESPUÉS de que ya se han comprometido (principio de Compromiso/Consistencia).


Categorías de Principios (11)

CategoríaConteoIdea Central
Atención4Los usuarios ven menos de lo que crees
Gestalt8La agrupación visual guía la comprensión
Memoria10El reconocimiento supera al recuerdo; fragmenta todo
Comprensión3Los modelos mentales moldean las expectativas
Toma de Decisiones5Menos opciones, resultados más claros
Motor/Interacción3Objetivos grandes, respuestas rápidas
Motivación4Autonomía + competencia + relación
Sesgos Cognitivos10Los valores predeterminados persisten; las primeras impresiones anclan
Persuasión9Confianza antes de preguntar; demuestra antes de prometer
Emoción6Lo bello se siente más fácil; el deleite gana lealtad
Ética3Línea clara entre persuasión y manipulación

Total: 65 principios — consulta knowledge/principles.md para la base de datos completa con definiciones e implicaciones de diseño.


Anti-Patrones (Nunca Hacer)

  • Contadores de escasez falsos — si no es real, no lo muestres
  • Confirmshaming — "No, no quiero ahorrar dinero" es manipulador
  • Costos ocultos al pagar — la causa #1 de abandono de carrito
  • Continuidad forzada — las suscripciones difíciles de cancelar erosionan toda la confianza
  • Desinformación — trucos visuales para forzar clics equivocados
  • Prueba social falsa — testimonios inventados o números inflados
  • Valores predeterminados oscuros — marcar previamente opciones que el usuario no solicitó
  • Patrones de motel de cucarachas — fácil de entrar, imposible de salir

Fuente

Principios derivados de la guía de Psicología para UX de NN/g (112 recursos en 11 categorías), adaptados en patrones de diseño accionables. Fundamentos académicos: Kahneman (Teoría de Prospectos), Norman (Diseño Emocional), Cialdini (Influencia), Hick, Fitts, Miller, Zeigarnik.

Skills relacionados