Skip to content
Back to search

inclusive-design-skills

Inclusive design skills for AI coding agents — from cognitive accessibility to adaptive interfaces, inclusive research, and accessibility decision-making.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/owl-listener--inclusive-design-skills/badge.svg)](/listings/owl-listener--inclusive-design-skills)

HTML

<a href="/listings/owl-listener--inclusive-design-skills"><img src="/api/listings/owl-listener--inclusive-design-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

Add the marketplace:

/plugin marketplace add Owl-Listener/inclusive-design-skills

Then run `/plugin`, open the **Discover** tab, and install the plugins you want.

Or get this collection plus four more in one go, through the full suite:

/plugin marketplace add Owl-Listener/designer-skills

Other Tools

Skills use the universal SKILL.md format. Copy the skill folders into your tool's skills directory, or reference them directly from this repo. Each SKILL.md file works as a standalone instruction set.

For manual use without a coding agent: open any SKILL.md file, copy the contents, and paste it as context at the start of a conversation with any AI assistant. The frameworks and decision criteria work regardless of the tool.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 48 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "inclusive-design-skills",
  4. "version": "1.0.0",
  5. "description": "Inclusive Design Skills: agentic skills for accessible, inclusive products \u2014 from cognitive accessibility to adaptive interfaces, inclusive research, and accessibility decisions.",
  6. "owner": {
  7. "name": "MC Dean",
  8. "url": "https://marieclairedean.substack.com/"
  9. },
  10. "plugins": [
  11. {
  12. "name": "cognitive-accessibility",
  13. "description": "Design for how people actually think: cognitive load, plain language, wayfinding, focus, memory, and error recovery.",
  14. "source": "./cognitive-accessibility",
  15. "category": "accessibility"
  16. },
  17. {
  18. "name": "inclusive-interaction",
  19. "description": "Design multi-modal interactions that adapt to how people move, perceive, and communicate.",
  20. "source": "./inclusive-interaction",
  21. "category": "accessibility"
  22. },
  23. {
  24. "name": "accessible-content",
  25. "description": "Structure content that works for screen readers, cognitive differences, and diverse literacy levels.",
  26. "source": "./accessible-content",
  27. "category": "accessibility"
  28. },
  29. {
  30. "name": "inclusive-personas",
  31. "description": "Build user stories, personas, and scenarios that include disability from the start.",
  32. "source": "./inclusive-personas",
  33. "category": "accessibility"
  34. },
  35. {
  36. "name": "adaptive-interfaces",
  37. "description": "Design systems that respect user preferences and adapt to individual needs.",
  38. "source": "./adaptive-interfaces",
  39. "category": "accessibility"
  40. },
  41. {
  42. "name": "accessibility-decisions",
  43. "description": "Document, communicate, and maintain accessibility decisions across teams and time.",
  44. "source": "./accessibility-decisions",
  45. "category": "accessibility"
  46. }
  47. ]
  48. }
README.md · README · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Inclusive Design Skills
  2. > **Part of the [Designer Skills suite](https://github.com/Owl-Listener/designer-skills).**
  3. > Install this collection and four more with one command in Claude Code:
  4. >
  5. > `/plugin marketplace add Owl-Listener/designer-skills`
  6. >
  7. > This repo still works on its own. The suite just gives everyone one front door.
  8. Agentic skills for designing accessible, inclusive products — from cognitive accessibility to adaptive interfaces, inclusive research, and accessibility decision-making.
  9. **40 skills** and **18 commands** across **6 plugins**.
  10. Works with any AI coding agent that supports the SKILL.md format: [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [OpenAI Codex](https://openai.com/index/codex/), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Cursor](https://www.cursor.com), and others.
  11. ## Why This Exists
  12. Every accessibility skill set that exists today is engineer-facing. They audit code, check WCAG compliance, validate ARIA attributes, and flag contrast ratios. They treat accessibility as a technical implementation problem that gets caught at the end.
  13. This collection operates **before code**. It shapes decisions about information architecture, language, interaction patterns, cognitive demands, and inclusion — the design layer that determines whether something is genuinely usable, not just technically compliant.
  14. Accessibility isn't a code review. It's a design commitment.
  15. ## Plugins
  16. | Plugin | Skills | Commands | Description |
  17. | --- | --- | --- | --- |
  18. | [cognitive-accessibility](cognitive-accessibility) | 8 | 3 | Design for how people actually think: cognitive load, plain language, wayfinding, focus, memory, and error recovery. |
  19. | [inclusive-interaction](inclusive-interaction) | 7 | 3 | Design multi-modal interactions that adapt to how people move, perceive, and communicate. |
  20. | [accessible-content](accessible-content) | 7 | 3 | Structure content that works for screen readers, cognitive differences, and diverse literacy levels. |
  21. | [inclusive-personas](inclusive-personas) | 6 | 3 | Build user stories, personas, and scenarios that include disability from the start. |
  22. | [adaptive-interfaces](adaptive-interfaces) | 6 | 3 | Design systems that respect user preferences and adapt to individual needs. |
  23. | [accessibility-decisions](accessibility-decisions) | 6 | 3 | Document, communicate, and maintain accessibility decisions across teams and time. |
  24. ## Quick Start
  25. ### Claude Code
  26. Add the marketplace:
  27. ```
  28. /plugin marketplace add Owl-Listener/inclusive-design-skills
  29. ```
  30. Then run `/plugin`, open the **Discover** tab, and install the plugins you want.
  31. Or get this collection plus four more in one go, through the full suite:
  32. ```
  33. /plugin marketplace add Owl-Listener/designer-skills
  34. ```
  35. ### Other Tools
  36. Skills use the universal SKILL.md format. Copy the skill folders into your tool's skills directory, or reference them directly from this repo. Each SKILL.md file works as a standalone instruction set.
  37. For manual use without a coding agent: open any SKILL.md file, copy the contents, and paste it as context at the start of a conversation with any AI assistant. The frameworks and decision criteria work regardless of the tool.
  38. ## What Are Skills and Commands?
  39. - **Skills** are domain knowledge units (nouns). They teach your AI agent about a specific aspect of inclusive design — like assessing cognitive load, writing plain language content, or designing forgiving error flows.
  40. - **Commands** are workflows (verbs). They chain multiple skills together to accomplish a task — like running a full cognitive accessibility review or generating an inclusive persona set.
  41. ## All Commands
  42. | Command | Plugin | Description |
  43. | --- | --- | --- |
  44. | `/cognitive-accessibility:review` | cognitive-accessibility | Run a full cognitive accessibility review of a flow or interface. |
  45. | `/cognitive-accessibility:simplify` | cognitive-accessibility | Simplify content and interactions to reduce cognitive load. |
  46. | `/cognitive-accessibility:assess-load` | cognitive-accessibility | Assess cognitive load across a multi-step process. |
  47. | `/inclusive-interaction:audit` | inclusive-interaction | Audit an interface for multi-modal interaction support. |
  48. | `/inclusive-interaction:design-flow` | inclusive-interaction | Design an interaction flow with inclusive input and output options. |
  49. | `/inclusive-interaction:keyboard-review` | inclusive-interaction | Review keyboard navigation and focus management. |
  50. | `/accessible-content:review` | accessible-content | Review content for accessibility across cognitive and literacy levels. |
  51. | `/accessible-content:rewrite` | accessible-content | Rewrite content in plain language while preserving meaning. |
  52. | `/accessible-content:structure` | accessible-content | Structure content for screen reader and assistive technology use. |
  53. | `/inclusive-personas:generate` | inclusive-personas | Generate a diverse, inclusive persona set for a product. |
  54. | `/inclusive-personas:audit-stories` | inclusive-personas | Audit user stories for disability inclusion. |
  55. | `/inclusive-personas:scenario-map` | inclusive-personas | Map inclusive usage scenarios across ability spectrums. |
  56. | `/adaptive-interfaces:specify` | adaptive-interfaces | Specify adaptive behaviour for an interface. |
  57. | `/adaptive-interfaces:preference-audit` | adaptive-interfaces | Audit respect for user preferences (motion, contrast, colour scheme). |
  58. | `/adaptive-interfaces:responsive-review` | adaptive-interfaces | Review responsive and flexible layout for accessibility. |
  59. | `/accessibility-decisions:document` | accessibility-decisions | Document accessibility decisions and tradeoffs for a feature. |
  60. | `/accessibility-decisions:review` | accessibility-decisions | Review and surface undocumented accessibility assumptions. |
  61. | `/accessibility-decisions:handoff` | accessibility-decisions | Generate an accessibility decision handoff for engineering. |
  62. ## Who This Is For
  63. - **Designers** who want to build accessibility into their process, not bolt it on after.
  64. - **Product managers** who need to make informed accessibility tradeoffs.
  65. - **Content strategists** who write for diverse cognitive and literacy levels.
  66. - **Researchers** who want to include disability in their work from the start.
  67. - **Engineers** who want design-informed accessibility guidance, not just code linting.
  68. - **Anyone** building products used by humans in the full range of human experience.
  69. ## Grounding and Sources
  70. Every skill in this collection is grounded in established frameworks, standards, and research. Nothing here is invented — it's existing accessibility knowledge structured into a format AI agents can use.
  71. ### Standards and Guidelines
  72. | Source | Used in | What I drew from |
  73. | --- | --- | --- |
  74. | [WCAG 2.2](https://www.w3.org/TR/WCAG22/) (W3C) | All plugins | Success criteria for visual, interaction, and content accessibility |
  75. | [COGA: Making Content Usable](https://www.w3.org/TR/coga-usable/) (W3C) | cognitive-accessibility | The 8 objectives for cognitive accessibility design |
  76. | [COGA Issue Papers](https://w3c.github.io/coga/issue-papers/) (W3C) | cognitive-accessibility | Research modules on cognitive disabilities and web access |
  77. | [WAI-ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/) (W3C) | inclusive-interaction, accessible-content | Keyboard patterns, roles, and states for interactive components |
  78. | [CSS Media Queries Level 5](https://www.w3.org/TR/mediaqueries-5/) (W3C) | adaptive-interfaces | prefers-reduced-motion, prefers-contrast, prefers-color-scheme |
  79. ### Frameworks and Methodologies
  80. | Source | Used in | What I drew from |
  81. | --- | --- | --- |
  82. | [Microsoft Inclusive Design Toolkit](https://inclusive.microsoft.design/) | inclusive-personas | Permanent, temporary, and situational impairment spectrum |
  83. | [Cognitive Load Theory](https://en.wikipedia.org/wiki/Cognitive_load_theory) (John Sweller) | cognitive-accessibility | Intrinsic, extraneous, and germane load framework |
  84. | [Plain Language Guidelines](https://www.plainlanguage.gov/) (US Government) | cognitive-accessibility, accessible-content | Readability principles and content simplification |
  85. | [Architecture Decision Records](https://adr.github.io/) | accessibility-decisions | Structure for documenting design decisions with context and rationale |
  86. | [W3C Alt Text Decision Tree](https://www.w3.org/WAI/tutorials/images/decision-tree/) | accessible-content | Framework for choosing appropriate alt text strategy |
  87. ### Research and Advocacy
  88. | Source | Used in | What I drew from |
  89. | --- | --- | --- |
  90. | [Nothing About Us Without Us](https://en.wikipedia.org/wiki/Nothing_About_Us_Without_Us) (Disability rights movement) | inclusive-personas, CONTRIBUTING.md | Principle of centring lived experience in design |
  91. | [WebAIM Screen Reader Survey](https://webaim.org/projects/screenreadersurvey10/) | inclusive-interaction | Real-world assistive technology usage patterns |
  92. | [WHO World Report on Disability](https://www.who.int/publications/i/item/9789241564182) | inclusive-personas | Global disability prevalence and population data |
  93. ### What I synthesised
  94. The **accessibility-decisions** plugin applies established software engineering practices (ADRs, technical debt tracking, stakeholder communication) to accessibility — a combination that doesn't have a single authoritative source but draws on how experienced accessibility practitioners actually work. The **inclusive-personas** plugin structures Microsoft's impairment spectrum into actionable persona and scenario templates. These are the synthesis of existing thinking, not novel frameworks.
  95. ## Contributing
  96. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding new skills, commands, and plugins.
  97. We particularly welcome contributions from people with lived experience of disability. Nothing about us without us.
  98. ## Related
  99. Part of the [Designer Skills suite](https://github.com/Owl-Listener/designer-skills), alongside design practice, AI product design, UX program management, and design leadership. Install everything with one command, or pick just the collections you need.
  100. ## License
  101. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.