OpenParable
Skip to content
← Back to skills

Nielsen Error Recovery

Design
nielsen-error-recovery

Nielsen Error Recovery is an Agent Skill for design published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Diseña mensajes de error claros que ayuden a los usuarios a recuperarse. Use cuando implemente manejo de errores, validaciones, o estados de fallo en la interfaz.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/nielsen-error-recovery-vjrivmon-setup-software-ia/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/nielsen-error-recovery, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Ayuda a los Usuarios a Reconocer, Diagnosticar y Recuperarse de Errores

Resumen

Los mensajes de error deben expresarse en lenguaje claro (sin códigos), indicar precisamente el problema y sugerir constructivamente una solución.

Origen

  • Autor: Jakob Nielsen
  • Año: 1994 (refinado 2020)
  • Fuente: Nielsen Norman Group - "10 Usability Heuristics for User Interface Design"

Fundamento Psicológico

Los errores causan frustración y pueden dañar la confianza del usuario en el sistema. Mensajes claros y accionables transforman una experiencia negativa en una oportunidad de aprendizaje. El modelo de procesamiento de errores de Reason sugiere que la recuperación requiere: detección, diagnóstico y corrección.

Aplicación en Diseño

Lenguaje Humano

  • Sin códigos técnicos: "Error 500" → "Algo salió mal"
  • Tono empático, no culpabilizador
  • Vocabulario del usuario, no del sistema
  • Brevedad sin perder claridad

Indicación Precisa

  • Señalar exactamente qué campo tiene el error
  • Highlight visual del elemento problemático
  • Scroll automático hacia el error
  • Íconos distintivos (⚠️, ❌)

Soluciones Constructivas

  • Sugerir cómo corregir el problema
  • Ofrecer acciones alternativas
  • Links a recursos de ayuda
  • Botones de retry cuando aplique

Prevención de Pérdida de Datos

  • Guardar borrador automáticamente
  • Mantener inputs válidos al corregir errores
  • No limpiar formularios completos por un error
  • Permitir volver atrás y editar

Ejemplos

  • GitHub: "File not found. Check if the file exists or if you have access"
  • Stripe: Errores de tarjeta específicos con sugerencias
  • Slack: "Can't reach Slack. Check your connection" con botón Retry
  • Twitter: Guarda borradores cuando falla el envío
  • Google Forms: Resalta campos específicos con error

Anti-patterns

  • ❌ "Error occurred" sin más información
  • ❌ Códigos hexadecimales o stack traces al usuario
  • ❌ Mensajes que culpan al usuario
  • ❌ Errores que desaparecen sin poder leerlos
  • ❌ Formularios que se limpian al fallar

Métricas

  • Error Recovery Rate: % usuarios que se recuperan exitosamente
  • Time to Recovery: Tiempo desde error hasta completar tarea
  • Repeat Error Rate: Mismo error cometido múltiples veces
  • Abandonment After Error: % que abandona tras un error

Principios Relacionados

  • [[nielsen-error-prevention]] - Mejor prevenir que curar
  • [[nielsen-visibility]] - Hacer visible el estado de error
  • [[postels-law]] - Aceptar variaciones, informar problemas

Referencias