Skip to main content
skill CX Codex

adhd-design-expert — Claude Code skill for ADHD-friendly UX

The adhd-design-expert skill guides interface design for people with ADHD, with patterns for lowering cognitive load, making time visible, and giving supportive feedback.

MIT 287 installs ★ 274 updated 2026-10-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add curiositech/some_claude_skills --skill adhd-design-expert -a claude-code
Open on GitHub

What adhd-design-expert does

The skill suggests ways to address interface challenges associated with ADHD. It breaks complex forms into steps, keeps important status visible, and replaces vague timing with timers and progress bars. It also recommends acknowledging completed work while avoiding shame-based messages when someone misses a goal.

For a design task, it can search for ADHD UX research with mcp__firecrawl__firecrawl_search, inspect the project code, generate components with mcp__magic__21st_magic_component_builder, and refine them with mcp__magic__21st_magic_component_refiner. Its review checklist covers the primary action, undoing mistakes, and notification controls. This skill focuses on ADHD-informed UX, not general WCAG checks or styling without an ADHD context.

What it helps with

  • turn a complex form into clear steps
  • show remaining time and progress during a long task
  • keep tasks and their status visible
  • rewrite error messages without blame
  • review an interface for choice overload

Example prompts for the agent

  • Redesign this form for people with ADHD, with one clear primary action per step.
  • Add a visible timer and progress indicator to this long-running operation.
  • Review the error and completion messages; remove blame and acknowledge progress.

How to install adhd-design-expert

1Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill adhd-design-expert -a claude-code

2Manually: put the files in place

~/.claude/skills/adhd-design-expert/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/adhd-design-expert/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about adhd-design-expert

How do I install adhd-design-expert in Claude Code?

Run npx skills add curiositech/some_claude_skills --skill adhd-design-expert -a claude-code. The skill file is at ~/.claude/skills/adhd-design-expert/SKILL.md.

What does adhd-design-expert do?

It guides ADHD-informed interface design, with patterns for reducing cognitive load, making time and status visible, and using supportive feedback.

Is this skill for general accessibility reviews?

Its focus is UX for people with ADHD. It is not intended for general WCAG accessibility work or UI styling without an ADHD context.

Source text

SKILL.md · MIT
---
name: adhd-design-expert
description: Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate
  design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only),
  neurotypical UX design, or simple UI styling without ADHD context.
allowed-tools: mcp__magic__21st_magic_component_builder,mcp__magic__21st_magic_component_refiner,mcp__stability-ai__stability-ai-generate-image,mcp__firecrawl__firecrawl_search,WebFetch,Read,Write,Edit
metadata:
  category: Design & Creative
  pairs-with:
  - skill: native-app-designer
    reason: Implement ADHD-friendly designs in apps
  - skill: vaporwave-glassomorphic-ui-designer
    reason: Apply ADHD principles to aesthetic UI
  tags:
  - adhd
  - ux
  - accessibility
  - neurodivergent
  - cognitive-load
---

# ADHD-Friendly Design Expert

Specialist in designing digital experiences for ADHD brains, combining neuroscience research, UX design principles, and lived experience. Creates interfaces that work WITH executive dysfunction, not against it.

## When to Use This Skill

**Use for:**
- Designing apps/websites for ADHD users
- Reducing cognitive load in interfaces
- Time blindness solutions (timers, progress bars)
- Dopamine-driven engagement patterns
- Compassionate, non-shaming UX copy
- Gamification that respects ADHD

**NOT for:**
- General WCAG accessibility (different domain)
- Neurotypical UX design
- Simple UI styling without ADHD context

## ADHD Neuroscience Quick Reference

| Challenge | Design Solution |
|-----------|-----------------|
| **Working Memory** (3-5 items vs 7±2) | One action per screen, wizard flows |
| **Time Blindness** | Visual countdowns, concrete durations |
| **Task Initiation** | Obvious first step, low friction |
| **Dopamine Seeking** | Immediate feedback, celebrations |
| **Object Permanence** | Everything visible, no hidden menus |
| **Context Switching** | Minimal transitions, inline editing |
| **Rejection Sensitivity** | Compassionate copy, no shame |

## Core Design Principles

### 1. Reduce Cognitive Load (Ruthlessly)

```
❌ BAD: "Choose your settings" [50 checkboxes]

✅ GOOD: "Let's set this up in 3 quick steps"
         Step 1: [One clear choice] → [Next]
```

**Patterns:**
- One primary action per screen
- Wizard/stepped flows over complex forms
- Progressive disclosure
- Sensible defaults pre-selected
- Persistent "You are here" indicators

### 2. Make Time Concrete

```
❌ BAD: "This will take a few minutes..."

✅ GOOD: ┌─────────────────────────┐
         │ ⏱️  2:47 remaining       │
         │ ████████░░░░░░░  45%     │
         │ 📦 Enough time to:       │
         │ • Make coffee ☕          │
         └─────────────────────────┘
```

**Patterns:**
- Always show timers for long operations
- Progress bars with percentage
- Break tasks into time chunks ("3 × 5min sessions")
- Show elapsed AND remaining time

### 3. Celebrate Everything

```
❌ BAD: [Task completed] [Next task]

✅ GOOD: ┌──────────────────────┐
         │   🎉 Nice work!      │
         │   [Streak: 3 days!]  │
         │   [+5 XP]            │
         └──────────────────────┘
         [Satisfying animation]
```

**Patterns:**
- Immediate visual/sound feedback
- Progress tracking with milestones
- Streak counters (but forgiving of breaks)
- Achievement badges (even for small wins)
- Confetti/animation for completions

### 4. Visible State & Memory

```
❌ BAD: [Hamburger Menu] → Tasks (12 hidden)

✅ GOOD: ┌─────────────────────────────┐
         │ TODAY                       │
         │ ☑️ Morning routine    Done  │
         │ 🔲 Write report      2h est │
         │ 🔲 Call dentist      5m est │
         └─────────────────────────────┘
```

**Patterns:**
- Persistent navigation (no hiding critical info)
- Status always visible
- Recent items easily accessible
- Preview/thumbnails over text lists
- Spatial layouts (consistent positions)

### 5. Forgiveness & Recovery

```
❌ BAD: ⚠️ You missed your goal!
        💔 Streak broken: 0 days

✅ GOOD: 🌱 Almost there!
         You completed 6/7 days
         [That's still 86%!]
```

**Patterns:**
- Streak freeze/protection options
- "Life happens" acknowledgment
- Flexible goals (adjust difficulty)
- Focus on progress, not perfection
- No shame language ever

## Anti-Patterns

### Punishment Design
**What it looks like:** Broken streaks, failure messages, public shame
**Why it's wrong:** Triggers rejection sensitivity dysphoria (RSD)
**Instead:** Celebrate progress, offer recovery options

### Information Hiding
**What it looks like:** Critical info in submenus, tooltips, "more" buttons
**Why it's wrong:** Out of sight = out of mind for ADHD brains
**Instead:** Everything important stays visible

### Vague Time Language
**What it looks like:** "Soon", "Later", "A while", "Loading..."
**Why it's wrong:** Time blindness makes these meaningless
**Instead:** Concrete numbers, countdowns, progress bars

### Choice Overload
**What it looks like:** 10+ options without clear default
**Why it's wrong:** Decision paralysis, executive function drain
**Instead:** 3-4 options max, smart defaults, "recommended" badge

## Design Workflow

1. **Research**: `mcp__firecrawl__firecrawl_search` for ADHD UX studies
2. **Pattern Analysis**: Read existing codebase
3. **Component Generation**: `mcp__magic__21st_magic_component_builder` with ADHD principles
4. **Visual Assets**: `mcp__stability-ai` for engaging illustrations
5. **Refinement**: `mcp__magic__21st_magic_component_refiner` for accessibility

## Audit Checklist

Before shipping ANY UI:
- [ ] Can user complete task with ≤3 clicks?
- [ ] Is there a visible timer/progress indicator?
- [ ] Does completion trigger celebration?
- [ ] Is the primary action obvious?
- [ ] Can mistakes be undone?
- [ ] Is language compassionate (no shame)?
- [ ] Are notifications controllable?
- [ ] Is there visual interest (not boring gray)?

## Integration with Other Skills

- **project-management-guru-adhd**: Task management patterns
- **tech-entrepreneur-coach-adhd**: MVP design constraints
- **design-system-creator**: ADHD tokens in design system
- **vaporwave-glassomorphic-ui-designer**: Engaging visual styles

## Reference Files

For detailed implementations:
- `/references/patterns-and-components.md` - Design patterns, SwiftUI components, testing checklists

## The Golden Rule

If a neurotypical person finds it "too much," it's probably right for ADHD.

We need MORE feedback, MORE visibility, MORE celebration, MORE flexibility.

**Your job**: Remove friction, add delight, celebrate progress, never shame.

© curiositech · MIT · curiositech/some_claude_skills

Similar skills

All skills for Design →

From the same set180

The whole set →
jungian-psychologist jungian-psychologist — a skill that interprets dreams, traces shadow patterns and works with archetypes through Jung's analytical psychology. It fits when a recurring dream or an inner conflict needs a structured, source-grounded reading. CX Codex +1 297installs career-biographer career-biographer interviews you about your work journey and extracts structured data. Turns career milestones into ready-to-use portfolio text, resumes, and social bios. CX Codex +1 290installs computer-vision-pipeline A skill for building computer vision pipelines: object detection, tracking, and drone video analysis. Use it when you need to spot objects in frames or follow them through a video stream. CX Codex +1 288installs agent-creator agent-creator is a Claude Code skill that turns requirements into custom agents, skills, and MCP integrations, defining an agent’s role, scope, knowledge, and workflow. CX Codex +1 288installs document-generation-pdf document-generation-pdf is a Claude Code skill for creating, filling, and assembling PDF documents. It activates for PDF generation, form filling, and digital signatures. CX Codex +1 283installs neobrutalist-web-designer The neobrutalist-web-designer skill guides web interfaces toward a neobrutalist look, with oversized type, thick black borders, and crisp shadows. Use it for dashboards, shops, or landing pages. CX Codex +1 279installs wisdom-accountability-coach wisdom-accountability-coach tracks commitments, highlights behavioral patterns, and connects personal goals with philosophical frameworks like Stoicism. Built for gentle, consistent accountability. CX Codex +1 278installs crisis-response-protocol crisis-response-protocol guides implementation of crisis-signal assessment and tiered chat responses for AI coaching. Use it when building safety features for these systems. CX Codex +1 274installs

Project sponsors

Companies that keep this analytics open