OpenParable
Skip to content
← Back to skills

Nielsen Help Documentation

Design
nielsen-help-documentation

Nielsen Help Documentation 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.

Proporciona documentación accesible y orientada a tareas. Use cuando diseñe sistemas de ayuda, onboarding, tooltips, o documentación de usuario.

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-help-documentation-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-help-documentation, 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 y Documentación

Resumen

Aunque es mejor si el sistema puede usarse sin documentación, puede ser necesario proporcionar ayuda y documentación. Esta información debe ser fácil de buscar, enfocada en la tarea del usuario, listar pasos concretos a seguir, y no ser demasiado extensa.

Origen

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

Fundamento Psicológico

Los usuarios acceden a la ayuda en momentos de frustración o bloqueo (help-seeking behavior). La documentación efectiva debe minimizar la carga cognitiva adicional y resolver el problema rápidamente. El modelo de aprendizaje situado indica que la ayuda contextual es más efectiva que manuales genéricos.

Aplicación en Diseño

Ayuda Contextual

  • Tooltips informativos en elementos complejos
  • Hints inline en formularios
  • Botones de "?" junto a funciones avanzadas
  • Onboarding tours para nuevas features

Documentación Estructurada

  • Búsqueda efectiva en docs
  • Categorización por tareas, no por features
  • Ejemplos y casos de uso concretos
  • Videos y GIFs para procesos complejos

Accesibilidad de la Ayuda

  • Accesible desde cualquier punto (F1, "?")
  • No bloquear la tarea actual al buscar ayuda
  • Quick start guides para empezar rápido
  • FAQs para problemas comunes

Formato Efectivo

  • Pasos numerados y concretos
  • Screenshots actualizados
  • Texto escaneable (headers, bullets)
  • Longitud apropiada (ni muy corto ni muy extenso)

Ejemplos

  • Notion: Help overlay contextual con search
  • Figma: Interactive tutorials integrados
  • Stripe Docs: Código ejecutable en la documentación
  • Slack: Tips del día y onboarding progresivo
  • GitHub: Guides paso a paso con screenshots

Anti-patterns

  • ❌ Manuales PDF de 200 páginas sin índice
  • ❌ Ayuda que requiere salir de la aplicación
  • ❌ Documentación desactualizada
  • ❌ Solo FAQs sin documentación estructurada
  • ❌ Chatbots que no resuelven problemas reales

Métricas

  • Help Seeking Frequency: Qué tan seguido los usuarios buscan ayuda
  • Help Success Rate: % que resuelve su problema con docs
  • Time in Documentation: Tiempo hasta encontrar respuesta
  • Search Success Rate: % de búsquedas exitosas en docs

Principios Relacionados

  • [[progressive-disclosure]] - Revelar complejidad gradualmente
  • [[nielsen-recognition-recall]] - Información visible cuando se necesita
  • [[nielsen-match-real-world]] - Lenguaje del usuario

Referencias