contextual-help-design

Define accessible on-screen guidance patterns as structured Markdown with testable criteria.

3|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/hulusi-tunc/unicorn-skills --skill contextual-help-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contextual-help-design
Source: https://github.com/hulusi-tunc/unicorn-skills/tree/main/.claude/skills-archive/cognitive-accessibility--contextual-help-design
Command: npx skills add https://github.com/hulusi-tunc/unicorn-skills --skill contextual-help-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design help that meets people where they are — on the screen they're stuck on, without forcing users to navigate away to seek guidance.

Core Features & Use Cases

  • Inline Help: Tooltip or info icon next to fields that need explanation, inline definitions, and "what's this" links.
  • Guided Tasks: Step-by-step wizards and templates that simplify complex forms and workflows.
  • Escalation Path: Self-service help (search, FAQ) as first option, followed by chat or human support, with estimated wait times.
  • Error Recovery Support: Error messages that explain what happened, why, and what to do next, with direct field focus.
  • Help Content Rules: Write at grade 4–6, use interface terminology, deliver one instruction per step, and ensure searchability.
  • Assessment Questions: 1) Can users get help without navigating away from their task? 2) Is help written in plain language that matches the interface? 3) Can users reach a human within 2 clicks when self-service fails? 4) Do help resources exist for the moments where users actually get stuck?

Quick Start

Audit a UI screen and add inline help, guided tasks, escalation options, and clear error recovery prompts to improve accessibility.

Frequently Asked Questions about contextual-help-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design contextual help that stays on the current screen?

Contextual help reduces user confusion by providing on-screen guidance through inline tooltips, info icons, and guided task wizards so users never navigate away to find support.

What is the best way to write help content for cognitive accessibility?

Help content for cognitive accessibility must be written at a grade 4-6 reading level, use exact interface terminology, deliver one instruction per step, and ensure phrases are easily searchable.

How do I create an escalation path for self-service help flows?

Escalation paths offer self-service options like search and FAQs first, followed by chat or human support with estimated wait times, ensuring users reach a human within two clicks if self-service fails.

Can I use tooltip design to support error recovery in complex forms?

Tooltip design supports error recovery by displaying messages that explain what happened, why it occurred, and what to do next, while directly focusing the user on the relevant form field.

What should be included in an onboarding audit for on-screen guidance?

An onboarding audit should verify that users can get help without leaving their task, reach a human within two clicks, and find plain language resources at moments where they actually get stuck.