Skip to content
Back to search

adhd-ui-ux

MarketplaceWorks with Claude CodeGitHub

ADHD-friendly UI/UX rules for apps, bots, onboarding and printed instructions. Works as a Claude Code skill or a plain guide.

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/madewithfelix--adhd-ui-ux/badge.svg)](/listings/madewithfelix--adhd-ui-ux)

HTML

<a href="/listings/madewithfelix--adhd-ui-ux"><img src="/api/listings/madewithfelix--adhd-ui-ux/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

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

Claude Code, as a plugin

/plugin marketplace add madewithfelix/adhd-ui-ux
/plugin install adhd-ui-ux@adhd-ui-ux

Claude Code, by copying

Copy the folder `skills/adhd-ui-ux` into `~/.claude/skills/` (just for you) or `.claude/skills/` inside a project (for everyone on that project).

Other tools

The skill is one Markdown file. Paste it into your assistant's custom instructions, or keep it in your repo and point the assistant at it.

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 · 21 lines
  1. {
  2. "name": "adhd-ui-ux",
  3. "owner": {
  4. "name": "Made With Felix"
  5. },
  6. "metadata": {
  7. "description": "ADHD-friendly UI/UX rules and review checklist, packaged as an agent skill",
  8. "version": "1.0.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "adhd-ui-ux",
  13. "description": "Ten rules, anti-patterns and a review checklist for designing apps, flows, messages and printed instructions that work for people with ADHD",
  14. "source": "./",
  15. "strict": false,
  16. "skills": [
  17. "./skills/adhd-ui-ux"
  18. ]
  19. }
  20. ]
  21. }
README.md · README · 69 lines
  1. # ADHD-friendly UI/UX
  2. Ten rules, a list of anti-patterns and a review checklist for designing things that work for people with ADHD: apps, chat bots, onboarding, error messages, reward systems, and even printed instruction cards.
  3. It is written as an **agent skill**, so AI coding assistants (such as Claude Code) can apply it automatically. It is also plain Markdown, so you can simply read it.
  4. > Design guidance only. Not medical or clinical advice.
  5. >
  6. > Focused on ADHD. Many rules also help other people, including autistic people, but this is not an autism guide. See [Related work](#related-work-and-sources) for broader guidance.
  7. ## The ten rules
  8. 1. One action per screen or step.
  9. 2. Core action in one step, details later.
  10. 3. Show progress and time, counting up.
  11. 4. Celebrate each finished step straight away.
  12. 5. Blame-free errors with one way forward.
  13. 6. No guilt for skipping or being away. No resetting streaks.
  14. 7. Resumable: never repeat a finished step.
  15. 8. One clear next action at the end.
  16. 9. Never judge the user's choices.
  17. 10. The user keeps control. No reward held hostage.
  18. The full reasoning, patterns, anti-patterns and checklist are in [`skills/adhd-ui-ux/SKILL.md`](skills/adhd-ui-ux/SKILL.md).
  19. ## Install
  20. ### Claude Code, as a plugin
  21. ```
  22. /plugin marketplace add madewithfelix/adhd-ui-ux
  23. /plugin install adhd-ui-ux@adhd-ui-ux
  24. ```
  25. ### Claude Code, by copying
  26. Copy the folder `skills/adhd-ui-ux` into `~/.claude/skills/` (just for you) or `.claude/skills/` inside a project (for everyone on that project).
  27. ### Other tools
  28. The skill is one Markdown file. Paste it into your assistant's custom instructions, or keep it in your repo and point the assistant at it.
  29. ## Use it
  30. Ask your assistant things like:
  31. - "Review this onboarding flow with the ADHD UX checklist."
  32. - "Make this error message ADHD-friendly."
  33. - "Design a reward system that never punishes."
  34. ## Related work and sources
  35. Worth reading, and partly the reason some rules exist here:
  36. - W3C, [Making Content Usable for People with Cognitive and Learning Disabilities](https://www.w3.org/TR/coga-usable/) (COGA), the most authoritative design-pattern guidance in this area.
  37. - Vitaly Friedman, [Designing For People With ADHD](https://smart-interface-design-patterns.com/articles/design-adhd/), Smart Interface Design Patterns.
  38. - Stéphanie Walter, [Neurodiversity and UX: essential resources](https://stephaniewalter.design/blog/neurodiversity-and-ux-essential-resources-for-cognitive-accessibility/).
  39. - GOV.UK, [Dos and don'ts on designing for accessibility](https://accessibility.blog.gov.uk/2016/09/02/dos-and-donts-on-designing-for-accessibility/).
  40. - [AuDHD UI Guide](https://github.com/Greyland-Fireworks/audhd-ui-guide), a much larger open-source guide, skill and framework for autistic and ADHD users. Use it for autism-specific guidance or a full toolkit; use this skill if you want one short ADHD-focused file.
  41. How this one is different: it is a single file, it covers motivation and rewards (streaks, points, guilt), and it applies to printed instructions and physical products, not only screens.
  42. ## Contributing
  43. Fork it, adapt it to your own product, and open a pull request if you find a rule that is wrong or missing. Please include a source or a real example. Contributions from autistic people and other neurodivergent people who want to extend the scope are very welcome.
  44. ## Credit
  45. Made by [Made With Felix](https://madewithfelix.com.au), a small Australian maker studio. Copyright (c) 2026 Made With Felix. Licensed under [CC BY 4.0](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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