Communitygithub.com

investigación-de-usuarios

Úsalo al planificar o sintetizar investigación de usuarios (entrevistas, pruebas de usabilidad, encuestas), mapear un recorrido o trabajo por hacer (JTBD), especificar los estados de una interacción o realizar una evaluación heurística de un flujo. No para menús, etiquetas, taxonomía o estructura del sitio; usa `arquitectura-de-información`. No para pulido visual; usa `diseñador`.

¿Qué es investigación-de-usuarios?

Este skill está diseñado para guiar a un agente de IA (como Claude Code, Cursor o Codex) en la planificación, ejecución y síntesis de investigación de usuarios. Proporciona un marco riguroso para investigaciones cualitativas y cuantitativas, incluyendo entrevistas, pruebas de usabilidad, mapeo de recorridos y especificaciones de interacción. Es útil para agentes que trabajan en el desarrollo de productos, ya que asegura que las decisiones de diseño se basen en evidencia en lugar de opiniones. El skill define reglas clave como la separación de observación, interpretación y recomendación, y la necesidad de documentar hallazgos con recuentos y fuentes. También incluye pautas para elegir métodos según la pregunta de investigación, realizar entrevistas efectivas y sintetizar datos. Soporta una amplia gama de plataformas de desarrollo de software y agentes de IA, y su documentación (SKILL.md) proporciona listas de verificación y advertencias para evitar errores comunes.

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

Preguntar en tu IA favorita

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

Documentación

Investigación de usuarios

Cómo las personas intentan realizar un trabajo con el producto, dónde fallan y qué debe hacer la interfaz en cada paso. La evidencia es lo primero. Un flujo diseñado desde la opinión es una suposición con un diagrama adjunto.

Límite: este skill abarca personas, tareas, flujos y estados de interacción. El skill arquitectura-de-información abarca cómo se organiza, etiqueta y encuentra el contenido. El skill diseñador abarca cómo se ve y se lee una pantalla.

Las reglas que más importan

  1. Escribe la pregunta de investigación antes de elegir un método. "¿Por qué los usuarios de prueba no invitan a un colega?" elige el método. "Hagamos algunas entrevistas" no elige nada.
  2. El comportamiento vence a la opinión. Lo que la gente hizo la última vez es evidencia. Lo que dicen que harían es un pronóstico, y malo. Pregunta sobre eventos pasados, observa tareas reales.
  3. Cada hallazgo lleva su recuento y su fuente. "4 de 6 participantes no vieron el botón guardar (sesiones 2, 3, 5, 6)" es un hallazgo. "A los usuarios les resultó confuso guardar" no lo es.
  4. Separa observación, interpretación y recomendación. Escríbelas en tres columnas. Mezclarlas oculta qué parte es evidencia y cuál eres tú.
  5. Cinco participantes por grupo de usuario distinto encuentra la mayoría de los problemas de usabilidad en una prueba cualitativa. No mide nada. Nunca cites un porcentaje de n=5.
  6. Cada especificación de interacción cubre todos los estados, no solo el camino feliz (ver más abajo).
  7. Di lo que la investigación no puede decirte. Toda síntesis termina con sus límites y las preguntas abiertas para la siguiente ronda.

Cuándo no usarlo

  • La pregunta es "¿dónde debería vivir este contenido?" o "¿qué debería decir este menú?": usa arquitectura-de-información.
  • La pregunta es "¿esto se ve cuidado?": usa diseñador o diseño-visual.
  • Necesitas una métrica con un intervalo de confianza: eso es análisis cuantitativo, usa análisis-de-datos. La investigación cualitativa encuentra los problemas; no los dimensiona.
  • Aceptación por parte del dueño del negocio: usa uat.

Elección de método (un valor predeterminado por pregunta)

PreguntaMétodo predeterminadoNotas
¿Qué problema tienen y cómo lo resuelven hoy?Entrevistas sobre la última ocurrencia real5 a 8 por segmento; detente cuando las nuevas sesiones dejen de añadir temas
¿Pueden completar esta tarea con este diseño?Prueba de usabilidad moderada, pensar en voz alta5 por grupo de usuario; tareas reales, sin pistas
¿Dónde en el flujo abandonan las personas?Análisis de embudo, luego prueba de usabilidad en el peor pasoLos datos dicen dónde; solo observar dice por qué
¿Cuáles de estas características importan?Cuestionario Kano o encuesta de tareas principalesNecesita una muestra lo suficientemente grande para contar, no 5
¿Cómo llaman a las cosas / cómo las agrupan?Clasificación de tarjetasEntrégaselo a arquitectura-de-información
¿Es la nueva versión mejor que la anterior?Mismas tareas, mismas métricas, ambas versionesDecide la métrica antes de la prueba

Combina una fuente cualitativa y una cuantitativa cuando la decisión sea costosa. Cuando no coinciden, el desacuerdo es el hallazgo: investiga, no promedies.

Entrevistas

  • Recluta personas que hayan tenido el problema recientemente. Una pregunta de filtro sobre la última vez que ocurrió descarta a quienes solo creen que lo tienen.
  • Pregunta sobre un evento pasado específico: "Cuéntame sobre la última vez que..." y luego sigue la historia. Las preguntas sobre el futuro ("¿Usarías...?") obtienen ficción cortés.
  • Sin preguntas tendenciosas. "¿Cómo decidiste?" no "¿El precio fue el factor principal?"
  • No promociones, demuestres ni defiendas el producto durante una entrevista. En el momento en que vendes, el participante comienza a complacerte.
  • El silencio es una herramienta. Espera tres segundos después de una respuesta antes de la siguiente pregunta.
  • Toma notas literales o graba con consentimiento. Las citas son evidencia; la paráfrasis no lo es.

Pruebas de usabilidad

Escribe el plan antes de reclutar:

Objetivo:        la decisión que informa esta prueba
Participantes:   quiénes, cuántos, criterios de filtro
Tareas:          3 a 6, cada una un objetivo realista en palabras del usuario, nunca la etiqueta de la interfaz
                 ("Quieres enviar la factura del mes pasado a tu contador",
                  no "Usa el botón Exportar")
Éxito:           qué cuenta como completado para cada tarea, decidido ahora
Medidas:         finalización, errores, tiempo, asistencias, calificación de facilidad posterior a la tarea
Guión:           introducción, consentimiento, calentamiento, tareas, preguntas de cierre
  • Una tarea que nombra el botón prueba la lectura, no la usabilidad.
  • Nota dónde duda el participante, retrocede o dice "Esperaba...". Esos son los problemas, incluso cuando la tarea se completa.
  • Clasifica cada problema por gravedad: bloquea la tarea, causa un retraso o error importante, molestia menor, cosmético. Arregla en ese orden.

Síntesis

  1. Coloca cada observación en su propia línea con ID de participante y sesión.
  2. Agrupa por patrón, no por pantalla. Nombra cada grupo como una oración de hallazgo.
  3. Cuenta los participantes detrás de cada hallazgo. Una cita vívida no es un patrón.
  4. Convierte cada hallazgo en un insight (por qué ocurre) y luego en una oportunidad ("¿Cómo podríamos...?"). Mantén visible la cadena: oportunidad, insight, hallazgo, notas brutas.
  5. Identifica segmentos a partir de los datos. Si dos grupos se comportan de manera diferente, repórtalos por separado, no los mezcles en un usuario promedio.
  6. Termina con notas metodológicas (quiénes, cuántos, cómo reclutados, qué no se cubrió) y preguntas para investigación adicional.

Trabajos por hacer (JTBD)

Para cada grupo de usuarios, nombra tres partes del trabajo:

  • Funcional: la tarea ("presentar mi declaración de impuestos trimestral").
  • Emocional: cómo quieren sentirse ("seguro de no haber cometido errores").
  • Social: cómo quieren ser vistos ("organizado frente a mi contador").

Diseña el flujo en función del trabajo, no de la lista de funciones. Una declaración de trabajo escrita desde las suposiciones del equipo, sin entrevista que la respalde, es una hipótesis. Etiquétala como tal.

Mapas de recorrido

  1. Declara el objetivo a nivel de recorrido.
  2. Divide en fases (por ejemplo: descubrir, decidir, comenzar, usar, obtener ayuda).
  3. Para cada fase: acciones, pensamientos, sentimientos, puntos de contacto. Marca cuáles provienen de investigación y cuáles se asumen.
  4. Marca momentos de verdad (donde se gana o pierde la relación), puntos débiles y brechas de oportunidad.

Un mapa de recorrido sin investigación detrás es una creencia compartida del equipo. Eso tiene valor, pero no es evidencia. Di cuál es en el mapa.

Especificación de interacción

Toda especificación de interacción cubre:

  • Camino feliz: el flujo esperado.
  • Camino de error: entrada no válida, solicitud fallida, tiempo de espera agotado, permiso denegado.
  • Estado vacío: aún no hay datos. El primer estado vacío es una invitación a la primera acción.
  • Estado de carga: lo que el usuario ve mientras espera, y después de cuánto tiempo cambia.
  • Estado parcial: algunos datos cargados, algunos fallaron.
  • Casos límite: nombres muy largos, cero, uno y muchos elementos, red lenta, botón de retroceso, doble envío, sesión expirada en medio del flujo.

Toque y entrada:

  • Objetivos táctiles de al menos 44 por 44 pt (iOS) o 48 por 48 dp (Android). Sin superposición.
  • Nunca coloques información o acciones esenciales detrás de un hover en un dispositivo táctil.
  • Cada flujo se completa solo con el teclado. El foco se mueve a un diálogo cuando se abre y vuelve al activador cuando se cierra.

Errores:

  • Prevén primero: restringe la entrada (selectores, listas), valida al perder el foco, nombra el objeto en una confirmación destructiva ("Eliminar 'Factura de marzo'", no "Eliminar elemento").
  • Prefiere deshacer a un cuadro de diálogo de confirmación para acciones reversibles.
  • Un mensaje de error dice qué salió mal, cómo solucionarlo y a quién contactar si el usuario no puede. "La contraseña debe tener al menos 8 caracteres" es mejor que "Entrada no válida".
  • Un formulario nunca borra la entrada del usuario en un error de validación.

Lee referencias/listas-de-verificacion-de-revision.md al realizar una evaluación heurística, verificar la carga cognitiva, diseñar la incorporación o clasificar características con el modelo Kano.

Advertencias

  • Preguntar a los usuarios qué quieren. Responden con funciones que han visto en otro lugar. Pregunta qué hicieron y qué se interpuso; deriva la función tú mismo.
  • Probar con colegas. Conocen las palabras y el modelo del producto. Su éxito no prueba nada sobre un extraño.
  • Reclutar solo clientes satisfechos. Las personas que se fueron o nunca se activaron tienen las respuestas más útiles. Reclútalos a propósito.
  • Contar un hallazgo de n=5 como una tasa. "El 60% falló" de 3 de 5 implica una precisión que no tienes. Di "3 de 5".
  • Una evaluación heurística presentada como investigación de usuarios. Una revisión de expertos encuentra problemas probables rápidamente. Es una predicción sobre los usuarios, no una observación de ellos. Etiquétala.
  • Una cita fuerte que impulsa la hoja de ruta. Verifica cuántas sesiones la respaldan antes de que llegue a una presentación.
  • Diseñar solo el camino feliz. Los estados vacío, de carga y de error son donde los nuevos usuarios pasan sus primeros minutos. Especificarlos primero si acaso.
  • Un flujo que funciona en la especificación pero no en la compilación. Recorre la compilación real con las mismas tareas antes de dar por terminada la investigación.

Verificación

El trabajo de investigación está hecho cuando:

  • La pregunta de investigación y la decisión que informa están escritas.
  • Cada hallazgo nombra su recuento de participantes y sesiones de origen.
  • Observación, interpretación y recomendación se mantienen separadas.
  • El contenido asumido (en mapas de recorrido, declaraciones de trabajo) está etiquetado como asumido.
  • Los límites y las preguntas abiertas están listados.
  • Cada especificación de interacción cubre estados feliz, de error, vacío, de carga, parcial y límite.
  • Las recomendaciones están clasificadas por gravedad y por cuántos usuarios afectan.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados