Agent skill

Contextual Help Design

by Owl-Listener in Owl-Listener/inclusive-design-skills

Design help systems and support patterns that work for people with cognitive disabilities.

MITAuto-check passedSales & Support

Install Contextual Help Design

skills CLI
$ npx skills add Owl-Listener/inclusive-design-skills --skill contextual-help-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Owl-Listener/inclusive-design-skills contextual-help-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Owl-Listener/inclusive-design-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cognitive-accessibility/skills/contextual-help-design .claude/skills/contextual-help-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
contextual-help-design
GitHub stars
104
Token cost
~615 tokens
SKILL.md length
309 words
Files
1
Skills in repo
55
Repo updated
First seen
Licence
MIT

At a glance

Design help systems and support patterns that work for people with cognitive disabilities.

  • Works in 4 steps: Can users get help without navigating… → Is help written in plain language that… → Can users reach a human within 2 clicks… → …
  • Designing help content
  • SKILL.md covers Core Principle, Design Patterns, Help Content Rules and Assessment Questions
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Contextual Help Design is an agent skill from Owl-Listener/inclusive-design-skills. Design help systems and support patterns that work for people with cognitive disabilities. Use when designing help content, tooltips, onboarding, FAQs, support flows, documentation, or any context where users need guidance. Triggers on: help, support, FAQ, tooltip, onboarding, tutorial, guidance, stuck, confused, documentation, instructions.

Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Help center and FAQ content. The repository describes itself as: Inclusive design skills for AI coding agents — from cognitive accessibility to adaptive interfaces, inclusive research, and accessibility decision-making. The licence is MIT.

When your agent uses it

  • Designing help content
  • Any context where users need guidance

Example prompts

  • “/contextual-help-design”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit 6e0740f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Contextual Help Design loads about 615 tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 309 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~615

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Owl-Listener/inclusive-design-skills at commit 6e0740f, republished under its MIT licence (© Owl-Listener). 309 words, ~615 tokens.

Download SKILL.mdSave it as .claude/skills/contextual-help-design/SKILL.md (or your agent's skills folder).
name
contextual-help-design
description
Design help systems and support patterns that work for people with cognitive disabilities. Use when designing help content, tooltips, onboarding, FAQs, support flows, documentation, or any context where users need guidance. Triggers on: help, support, FAQ, tooltip, onboarding, tutorial, guidance, stuck, confused, documentation, instructions.

Contextual Help Design

Design help that meets people where they are — on the screen they're stuck on, in language they understand, without requiring them to remember how they got there.

Core Principle

If a user gets stuck, they should be able to get help without leaving the screen they're on.

Design Patterns

Inline Help
  • Tooltip or info icon next to fields that need explanation
  • Examples shown next to input fields ("e.g., 15/03/2026")
  • Help text visible by default for complex fields
  • Inline definitions for specialist terms (underline + tooltip)
  • "What's this?" links for uncommon concepts
Guided Tasks
  • Step-by-step wizard as an alternative to complex forms
  • Examples of completed tasks (filled-in sample forms)
  • Templates or pre-built options alongside "start from scratch"
  • Progress-aware hints that change based on where the user is
Escalation Path
  • Self-service help (search, FAQ) as first option
  • Chat or messaging as second option
  • Phone or video as third option
  • Never require users to re-explain when escalating between channels
  • Show estimated wait times for human support
  • Never require a reference number to get help
Error Recovery Support
  • Error messages include: what happened + why + what to do next
  • Link directly to the field or step that needs fixing
  • Offer alternative paths when primary fails
  • For complex errors: offer human support directly

Help Content Rules

  • Write at grade 4–6 reading level
  • Use the same terminology as the interface (not different words)
  • One instruction per step
  • Include images or diagrams for spatial or procedural instructions
  • Make help searchable
  • Test help content with people who have the actual problem

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 (not just the moments you anticipated)?

© Owl-Listener, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cognitive-accessibility/skills/contextual-help-design of Owl-Listener/inclusive-design-skills.

Open the folder on GitHubat commit 6e0740f

Compare with similar skills

Contextual Help Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Contextual Help Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Contextual Help Design this skillOwl-Listener/inclusive-design-skills104—~615Automated safety check: PassMIT
Brand Product Knowledge Builderlimecloud/lime1.5k—~709Automated safety check: PassApache-2.0
Cc10x Guideromiluz13/cc10x164—~2.2kAutomated safety check: PassMIT
Yao Geo Intent Mineryaojingang/yao-geo-skills871—~500Automated safety check: PassMIT
Faq CollectorCherryHQ/cherry-studio52k—~154Automated safety check: PassAGPL-3.0
Eol Internal Enablementdeanpeters/Product-Manager-Skills7.2k—~3.1kAutomated safety check: PassCustom licence

Similar skills

  • 将品牌产品资料、规格参数、卖点证据、FAQ、价格权益、竞品区别和合规边界,整理成符合 Agent Knowledge v0.6 document-first 标准、可被 AI 安全调用的产品资料知识库。适用于用户要求“整理产品知识库”“沉淀产品 FAQ”“把品牌产品资料变成项目资料”“维护产品资料包”的场景。

    1.5k GitHub stars~709 tokensUpdated today
    Sales & SupportAuto-check passed
  • Cc10x Guide

    romiluz13/cc10x

    Answers questions about cc10x itself — what it is, how to install and configure it, how the router, workflows, memory, and hooks operate, and how to troubleshoot.

    164 GitHub stars~2.2k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Yao Geo Intent Miner

    yaojingang/yao-geo-skills

    A skill your agent uses when a user asks for GEO 意图拓词、AI 搜索意图挖掘、AI 搜索问题集、问题簇、追问链路、查询重写、内容选题库、FAQ 题库、监测 Prompt 库, or AI Intent Miner.

    871 GitHub stars~500 tokensUpdated 8 days ago
    Sales & SupportAuto-check passed
  • Faq Collector

    CherryHQ/cherry-studio

    将成功解决的用户问题收录到 FAQ 知识库。问题解决后自动判断是否收录。也可以在用户说"收录到 FAQ"、"记录这个问题"、"add to FAQ"时手动触发。

    52k GitHub stars~154 tokensUpdated today
    Sales & SupportAuto-check passed
  • Eol Internal Enablement

    deanpeters/Product-Manager-Skills

    Build the support FAQ, sales talking points, and objection handling teams need before an EOL announcement.

    7.2k GitHub stars~3.1k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • Satisfaction Feedback

    Harryoung/efka

    Handle user satisfaction feedback. An agent skill from Harryoung/efka.

    104 GitHub stars~346 tokensUpdated 6 mo ago
    Sales & SupportAuto-check passed

More from Owl-Listener/inclusive-design-skills

All 55 skills in this repo
  • Assistive Technology Scenarios

    Owl-Listener/inclusive-design-skills

    Writes usage scenarios, use cases and storyboards that show real people using screen readers, switches, voice control and other assistive technology to finish tasks.

    104 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Error Prevention and Recovery

    Owl-Listener/inclusive-design-skills

    Designs forgiving forms and flows: prevent input errors, write messages that say what happened and what to do, and add undo, confirmation and recovery paths.

    104 GitHub stars~739 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessible Heading Structure

    Owl-Listener/inclusive-design-skills

    Designs heading hierarchies for screen reader navigation and cognitive accessibility on pages, articles, dashboards and forms.

    104 GitHub stars~763 tokensUpdated 4 mo ago
    Auto-check passed
  • Ability Spectrum Mapping

    Owl-Listener/inclusive-design-skills

    Maps a feature across a range of vision, hearing, motor and cognitive ability to find where the design starts to fail, and to explain accessibility scope to stakeholders.

    104 GitHub stars~917 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessibility Debt Tracking

    Owl-Listener/inclusive-design-skills

    Track and manage accessibility debt — known accessibility issues that have been deferred.

    104 GitHub stars~869 tokensUpdated 4 mo ago
    Auto-check passed
  • Accessibility Testing Strategy

    Owl-Listener/inclusive-design-skills

    Plan what to test, how to test, and who should test for accessibility.

    104 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed

Categories

Questions about Contextual Help Design

What does Contextual Help Design do?

Design help systems and support patterns that work for people with cognitive disabilities. Contextual Help Design is an agent skill from Owl-Listener/inclusive-design-skills. Design help systems and support patterns that work for people with cognitive disabilities.

When should I use Contextual Help Design?

Contextual Help Design fits situations like: designing help content; any context where users need guidance.

How do I install Contextual Help Design in Claude Code?

Run `npx skills add Owl-Listener/inclusive-design-skills --skill contextual-help-design -a claude-code`. Or copy the skill folder (cognitive-accessibility/skills/contextual-help-design in Owl-Listener/inclusive-design-skills) into .claude/skills/contextual-help-design in your project. Claude Code loads it when a task matches its description.

How do I install Contextual Help Design in Codex?

Run `npx skills add Owl-Listener/inclusive-design-skills --skill contextual-help-design -a codex`. Or copy the skill folder (cognitive-accessibility/skills/contextual-help-design in Owl-Listener/inclusive-design-skills) into .agents/skills/contextual-help-design in your project. Codex loads it when a task matches its description.

Can I use Contextual Help Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Owl-Listener/inclusive-design-skills --skill contextual-help-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/contextual-help-design, .gemini/skills/contextual-help-design, .github/skills/contextual-help-design and .opencode/skills/contextual-help-design in your project.

What does Contextual Help Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Contextual Help Design is instructions for the agent only.

Does Contextual Help Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Contextual Help Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Contextual Help Design use?

Contextual Help Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Contextual Help Design use?

About 615 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Contextual Help Design?

Skills that share tags, products or a category with Contextual Help Design: Brand Product Knowledge Builder (limecloud/lime, 1.5k stars), Cc10x Guide (romiluz13/cc10x, 164 stars), Yao Geo Intent Miner (yaojingang/yao-geo-skills, 871 stars) and Faq Collector (CherryHQ/cherry-studio, 52k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Contextual Help Design?

Owl-Listener (a GitHub user) maintains it in Owl-Listener/inclusive-design-skills, which has 104 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on June 9, 2026.

Source: Owl-Listener/inclusive-design-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.