Agent skill

Inclusive Design

by evanca in evanca/flutter-ai-rules

A skill your agent uses when working on inclusion, i18n/localization, global name/address forms, low-end devices, slow/metered networks, affordability, or first-time/low-confidence users; not…

MITAuto-check passedFrontend & Design

Install Inclusive Design

skills CLI
$ npx skills add evanca/flutter-ai-rules --skill inclusive-design -a claude-code

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

GitHub CLI
$ gh skill install evanca/flutter-ai-rules inclusive-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/evanca/flutter-ai-rules.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/inclusive-design .claude/skills/inclusive-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
inclusive-design
GitHub stars
650
Token cost
~2k tokens
SKILL.md length
982 words
Files
5 (incl. references)
Skills in repo
37
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when working on inclusion, i18n/localization, global name/address forms, low-end devices, slow/metered networks, affordability, or first-time/low-confidence users; not…

  • Works in 3 steps: Disability — and exclusion in general —… → Microsoft's three principles of… → The Persona Spectrum
  • Working on inclusion
  • SKILL.md covers When to use, The core mental model, How to run an inclusion review and A note on doing this well, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Inclusive Design is an agent skill from evanca/flutter-ai-rules. Use when working on inclusion, i18n/localization, global name/address forms, low-end devices, slow/metered networks, affordability, or first-time/low-confidence users; not WCAG/screen readers (see accessibility).

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/cognitive-load-and-wellbeing.md`, `references/digital-and-economic-inclusion.md` and `references/frameworks.md`).

It sits in Frontend & Design, covering Accessibility and Internationalization. The repository describes itself as: Flutter AI Skills and Rules for Claude, Codex, Cursor, and Other AI-Powered IDEs. The licence is MIT.

When your agent uses it

  • Working on inclusion
  • I18n/localization
  • Global name/address forms
  • Low-end devices

Example prompts

  • “/inclusive-design”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Disability — and exclusion in general — is a mismatch, not a trait
  2. Microsoft's three principles of inclusive design
  3. The Persona Spectrum

What it can do on your machine

Read from SKILL.md and the folder at commit 7b9cce2. 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

    Links to these hosts (documentation or services it may open):

    • inclusive.microsoft.design
    • w3.org
    • itu.int

    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

Inclusive Design loads about 2k tokens when it runs, and up to ~6.8k if it reads all its reference files. Until then it costs about 57 tokens; SKILL.md has 982 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.8k

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 evanca/flutter-ai-rules at commit 7b9cce2, republished under its MIT licence (© evanca). 982 words, ~1,956 tokens.

Download SKILL.mdSave it as .claude/skills/inclusive-design/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
inclusive-design
description
Use when working on inclusion, i18n/localization, global name/address forms, low-end devices, slow/metered networks, affordability, or first-time/low-confidence users; not WCAG/screen readers (see accessibility).
license
MIT

Inclusive Design

Inclusive design answers a different question from accessibility:

Does this respect the real-world context, identity, language, culture, device, confidence level, and constraints of the person using it?

Accessibility asks whether someone can operate the interface with their abilities and assistive tools. Inclusion asks who gets left out by the assumptions baked into the product — the person on a $40 phone over a metered 2G connection, the person whose name doesn't fit your form, the person reading in their third language, the person who has never done this online before and is afraid of getting it wrong. WCAG conformance does not address any of that. This skill does.

Per W3C, accessibility, usability, and inclusion overlap but each has a distinct focus: accessibility targets disability, usability targets the quality of the experience (effective, efficient, satisfying), and inclusion targets the full breadth of human diversity — hardware and software, literacy, economic situation, education, geography, culture, age, and language.

When to use

Use this skill when the work is about who you might be excluding and why — not about a specific assistive-tech bug. Triggers: reviewing a design "through an inclusive lens," building personas, internationalization/localization, designing name/address/profile forms for a global audience, supporting low-end devices or poor connectivity, lowering cost/data barriers, onboarding nervous or first-time users, reducing stress and cognitive load, or any "are we leaving anyone out?" conversation.

When not to use it: if the task is screen-reader support, keyboard navigation, focus order, color contrast, alt text, ARIA, captions, or passing WCAG — that's the accessibility skill. The two are partners; pick by focus.

The core mental model

1. Disability — and exclusion in general — is a mismatch, not a trait

The social model reframes disability as a mismatch between a person and their environment, product, or society — not a deficiency in the person. As August de los Reyes put it:

"The biggest challenge is reframing disability as a mismatch between one's abilities and the environment. In other words, disability is designed."

The empowering corollary: if mismatches are designed, they can be un-designed. The same logic extends past disability to every exclusion in this skill — a form that rejects a valid name, an app that needs more bandwidth than a user can afford, copy only a fluent reader can parse. Each is a designed mismatch you can remove. Microsoft states it as: disability = mismatched human interactions.

2. Microsoft's three principles of inclusive design
  • Recognize exclusion. "Exclusion happens when we solve problems using our own biases." Start by finding who your current solution shuts out.
  • Learn from diversity. "Human beings are the real experts in adapting to diversity." The people at the edges are the source of insight, not an afterthought.
  • Solve for one, extend to many. Design a great solution for one excluded person by "focusing on what's universally important to all humans" — and it tends to help everyone. Captions (built for Deaf users) help in loud airports and teach kids to read; high-contrast modes (built for low vision) help everyone in bright sun. Build for one, benefit many.
3. The Persona Spectrum

A constraint is rarely permanent-only. Microsoft's Persona Spectrum maps each limitation across permanent, temporary, and situational states — which both grows the affected population enormously and reveals the universal need:

AbilityPermanentTemporarySituational
Touch (one arm)amputationbroken arma new parent holding a baby
Seeblindnesscataracts / eye dilationdriving; bright sunlight
Heardeafnessear infectiona loud bar; a quiet library
Speaknon-verballaryngitisa heavy accent on voice UI

"We use the Persona Spectrum to understand related mismatches and motivations across a spectrum of permanent, temporary, and situational scenarios."

The scaling is the point: ~26,000 Americans a year experience permanent upper-limb loss, but counting temporary and situational impairments the number is more than 20 million. Designing for the edge serves the middle.

Show full SKILL.md (349 more words)Show less

How to run an inclusion review

Go dimension by dimension and ask "who does this assume, and who does that leave out?" Each dimension has a reference file with the depth.

  1. Language & culture — Is content translatable and localizable? Do name, address, date, number, and currency formats assume one culture? Do forms assume everyone has a first + last name? → references/language-and-culture.md
  2. Device, network & economics — Does it work on a cheap, old, small-screen phone over a slow, metered connection? Does it assume always-on connectivity, the latest hardware, or that data is free? Is there a low-bandwidth or offline path? → references/digital-and-economic-inclusion.md
  3. Confidence, stress & cognitive load — Does it respect that the user may be anxious, distracted, new, or low on mental energy? Does it give control, celebrate progress, and forgive mistakes rather than blame the user? → references/cognitive-load-and-wellbeing.md
  4. Identity & life stage — Does it represent diverse people respectfully (names, genders, family structures, skin tones, examples)? Does it work for the very young, the very old, and the first-time-online?
  5. Recognize your own exclusion — Whose biases shaped the defaults? Who wasn't in the room? Build a Persona Spectrum for the riskiest constraint and design for its edge.

For the philosophy, principles, Persona Spectrum activities, and the accessibility/usability/inclusion distinction in full, see references/frameworks.md.

A note on doing this well

Inclusion is not a checklist you complete; it's a habit of noticing your assumptions. The fastest way to find exclusion is to stop designing for an "average user" (who doesn't exist) and instead pick a specific person at the edge — someone unlike you in language, income, device, or confidence — and walk your flow as them. The friction they hit is the design's, not theirs.

References

Primary sources:

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

Files

SKILL.md and 4 other files (references) in skills/inclusive-design of evanca/flutter-ai-rules.

  • SKILL.md
  • references/cognitive-load-and-wellbeing.md
  • references/digital-and-economic-inclusion.md
  • references/frameworks.md
  • references/language-and-culture.md

Open the folder on GitHubat commit 7b9cce2

Compare with similar skills

Inclusive 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.

Inclusive Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Inclusive Design this skillevanca/flutter-ai-rules650—~2kAutomated safety check: PassMIT
Locale UI Patternsopenchamber/openchamber11k—~1.5kAutomated safety check: PassMIT
Instui Docsinstructure/instructure-ui482—~498Automated safety check: PassCustom licence
Accessibility I18ndevcodex-labs/devcodex439—~718Automated safety check: PassAGPL-3.0
Wfa Avalonia UItautcony/ChapterTool113—~1.1kAutomated safety check: PassGPL-3.0
Dotnet UInovotnyllc/dotnet-artisan232—~1.3kAutomated safety check: PassMIT

Similar skills

  • Locale UI Patterns

    openchamber/openchamber

    A skill your agent uses when creating or modifying OpenChamber UI text, labels, buttons, placeholders, aria labels, empty states, toasts, dialogs, settings copy, navigation labels, or any…

    11k GitHub stars~1.5k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Instui Docs

    instructure/instructure-ui

    Look up authoritative Instructure UI (InstUI, @instructure/ui-) documentation — component APIs, props, theme variables, usage examples, and guides — by querying instructure.design's plaintext docs.

    482 GitHub stars~498 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Accessibility I18n

    devcodex-labs/devcodex

    无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用;要求把包容性体验和本地化验证绑定到真实用户路径。

    439 GitHub stars~718 tokensUpdated 23 days ago
    Frontend & DesignAuto-check passed
  • Wfa Avalonia UI

    tautcony/ChapterTool

    Phase D of a WinForms-to-Avalonia migration: build the Avalonia UI shell with composition, MVVM state and commands, responsive XAML, accessibility, localization boundaries, and behavior-focused…

    113 GitHub stars~1.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Dotnet UI

    novotnyllc/dotnet-artisan

    Builds .NET UI apps across Blazor (Server, WASM, Hybrid, Auto), MAUI (XAML, MVVM, Shell, Native AOT), Uno Platform (MVUX, Extensions, Toolkit), WPF (.NET 8+, Fluent theme), WinUI 3 (Windows App SDK…

    232 GitHub stars~1.3k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Generated Media QA

    calesthio/generative-media-skills

    Provider-independent quality assurance for AI-generated and AI-assisted media.

    197 GitHub stars~8k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed

More from evanca/flutter-ai-rules

All 37 skills in this repo
  • Code Review

    evanca/flutter-ai-rules

    A skill your agent uses when asked to review a PR, MR, branch, or diff, audit changed files, or check code quality.

    650 GitHub stars~2.4k tokensUpdated 26 days ago
    Auto-check passed
  • Developing Genkit Dart

    evanca/flutter-ai-rules

    A skill your agent uses when building AI agents in Dart, implementing Genkit flows or tools, integrating LLMs into Dart or Flutter applications, or using Genkit Dart plugins.

    650 GitHub stars~961 tokensUpdated 26 days ago
    Auto-check passed
  • Generate Images With Firebase AI

    evanca/flutter-ai-rules

    A skill your agent uses when generating or editing images from Flutter/Dart with Firebase AI Logic and a Gemini image model (Nano Banana), making the first call work, choosing Gemini Developer API…

    650 GitHub stars~2.3k tokensUpdated 26 days ago
    Auto-check passed
  • Flutter Use Column Row First

    evanca/flutter-ai-rules

    A skill your agent uses when building any Flutter screen or component to choose responsive Row, Column, Expanded, Flexible, and Spacer layouts before fixed-size or coordinate-based alternatives.

    650 GitHub stars~1.3k tokensUpdated 26 days ago
    Auto-check passed
  • Architecture Feature First

    evanca/flutter-ai-rules

    A skill your agent uses when creating a feature, designing folder structure, adding repositories/services/view models, wiring dependency injection, or deciding which layer owns logic.

    650 GitHub stars~1.9k tokensUpdated 26 days ago
    Auto-check passed
  • Bloc

    evanca/flutter-ai-rules

    A skill your agent uses when creating a Cubit or Bloc, modeling state with sealed classes or status enums, wiring BlocBuilder/BlocListener/BlocProvider, writing bloc tests, or choosing between Cubit…

    650 GitHub stars~2.8k tokensUpdated 26 days ago
    Auto-check passed

Questions about Inclusive Design

What does Inclusive Design do?

A skill your agent uses when working on inclusion, i18n/localization, global name/address forms, low-end devices, slow/metered networks, affordability, or first-time/low-confidence users; not…. Inclusive Design is an agent skill from evanca/flutter-ai-rules. Use when working on inclusion, i18n/localization, global name/address forms, low-end devices, slow/metered networks, affordability, or first-time/low-confidence users; not WCAG/screen readers (see accessibility).

When should I use Inclusive Design?

Inclusive Design fits situations like: working on inclusion; I18n/localization; global name/address forms; low-end devices.

How do I install Inclusive Design in Claude Code?

Run `npx skills add evanca/flutter-ai-rules --skill inclusive-design -a claude-code`. Or copy the skill folder (skills/inclusive-design in evanca/flutter-ai-rules) into .claude/skills/inclusive-design in your project. Claude Code loads it when a task matches its description.

How do I install Inclusive Design in Codex?

Run `npx skills add evanca/flutter-ai-rules --skill inclusive-design -a codex`. Or copy the skill folder (skills/inclusive-design in evanca/flutter-ai-rules) into .agents/skills/inclusive-design in your project. Codex loads it when a task matches its description.

Can I use Inclusive 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 evanca/flutter-ai-rules --skill inclusive-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/inclusive-design, .gemini/skills/inclusive-design, .github/skills/inclusive-design and .opencode/skills/inclusive-design in your project.

What does Inclusive Design need to run?

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

Does Inclusive Design access the network?

SKILL.md names 3 domains. As links in the text: inclusive.microsoft.design, w3.org and itu.int. This is read from the text; nothing was executed.

Is Inclusive 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 Inclusive Design use?

Inclusive Design is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Inclusive Design use?

About 2k tokens (SKILL.md is roughly 7.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.8k tokens, read only when the agent opens those files.

What are the alternatives to Inclusive Design?

Skills that share tags, products or a category with Inclusive Design: Locale UI Patterns (openchamber/openchamber, 11k stars), Instui Docs (instructure/instructure-ui, 482 stars), Accessibility I18n (devcodex-labs/devcodex, 439 stars) and Wfa Avalonia UI (tautcony/ChapterTool, 113 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Inclusive Design?

evanca (a GitHub user) maintains it in evanca/flutter-ai-rules, which has 650 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on September 14, 2026.

Source: evanca/flutter-ai-rules on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.