About scenario-map
scenario-map is a design skill for mapping how product tasks work across abilities, assistive technologies, and situational contexts. It identifies high-risk combinations, gaps, and priority fixes.
Key features
- 01List a product's core tasks
- 02Map tasks across ability spectrums
- 03Overlay situational contexts
- 04Develop high-risk usage scenarios
- 05Prioritize gaps and fixes
Use cases
- 01Reviewing accessibility of a product feature
- 02Finding barriers compounded by context
- 03Prioritizing fixes by impact and severity
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ owl-listener/ inclusive-design-skills --skill scenario-mapAfter installing, type/scenario-mapin Claude Code to confirm it loaded.
Details
From the project READMEMap Inclusive Usage Scenarios
Generate a comprehensive map of how a product or feature is experienced across different abilities, technologies, and contexts — surfacing gaps before users find them.
Process
Step 1: Identify Core Tasks
List the 5–10 most important tasks for the product or feature. Focus on the tasks that matter most to users — the ones where failure means the product has failed.
Step 2: Map the Ability Spectrum
Using ability-spectrum-mapping, for each core task, rate performance across vision, hearing, motor, and cognitive spectrums. Identify the breakpoints where each task degrades or fails.
Step 3: Map Situational Contexts
Using situational-impairment-mapping, identify the realistic contexts where users encounter your product and the impairments those contexts create. Cross-reference with the ability spectrum to find compounding effects.
Step 4: Write Critical Scenarios
Using assistive-technology-scenarios, write detailed scenarios for the highest-risk combinations: the tasks most likely to fail for the users most likely to be affected.
Prioritise:
- Core tasks that fail at common ability levels
- Situational contexts that affect large user populations
- Combinations where multiple impairments compound
Step 5: Identify Gaps and Priorities
Map all findings into a single view showing:
- Which tasks work for whom
- Where the breakpoints are
- Which fixes would include the most users
Output
Deliver a scenario map containing:
- Task × ability matrix — showing works / friction / fails for each combination
- Situational context overlay — which contexts compound which ability barriers
- Critical scenarios — detailed narratives for highest-risk combinations
- Gap analysis — where the product fails and for whom
- Priority fixes — ranked by number of users unblocked and severity of current failure