Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Design & UI

neurodivergent-visual-org

Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns. Auto-detects overwhelm, provides compassionate task breakdowns with realistic time estimates.

Jack Reis · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add JackReis/neurodivergent-visual-org --skill neurodivergent-visual-org

About this skill


name: neurodivergent-visual-org description: | Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns. Auto-detects overwhelm, provides compassionate task breakdowns with realistic time estimates. allowed-tools: Read, Write, Edit, Grep, Glob, Bash license: MIT metadata: version: 3.1.1 author: Jack Reis

Mode System (v3.1.1)

This skill supports four modes to adapt to different cognitive styles and accessibility needs:

Mode Selection

Base Modes (choose one):

  1. Neurodivergent Mode - ADHD-friendly, energy-aware, compassionate language
  2. Neurotypical Mode - Direct, efficient, standard cognitive load

Accessibility Modes (optional, combinable with base modes): 3. Colorblind-Safe Mode - Pattern-based differentiation for all color vision types 4. Monochrome Mode - Pure black & white optimized for printing and e-ink displays

Mode Combinations Available:

  • Neurodivergent + Colorblind-Safe
  • Neurodivergent + Monochrome
  • Neurotypical + Colorblind-Safe
  • Neurotypical + Monochrome
  • Colorblind-Safe only (no base mode features)
  • Monochrome only (no base mode features)

Selection Methods:

1. Auto-Detect (Default)

  • Analyzes user language for distress signals ("overwhelmed", "paralyzed", "stuck")
  • Detects mentions of neurodivergent conditions or executive dysfunction
  • Detects accessibility requests ("colorblind-safe", "print-friendly", "grayscale")
  • Defaults to neurodivergent mode when ambiguous (inclusive design)

2. Explicit Mode Request

  • User says: "Use neurotypical mode" or "Use ADHD mode"
  • User says: "Use colorblind-safe mode" or "Make it print-friendly"
  • User says: "Combine neurodivergent and colorblind-safe modes"
  • Persists for current conversation unless changed

3. Configuration File

  • User creates: .claude/neurodivergent-visual-org-preference.yml
  • Sets default base mode, accessibility modes, time multipliers, chunk sizes
  • Can set auto-enable rules (e.g., monochrome for PDFs)

Mode Characteristics

Base Mode Features:

AspectNeurodivergent ModeNeurotypical Mode
Chunk size3-5 items5-7 items
Time estimates1.5-2x with bufferStandard
Task granularity3-10 min micro-steps15-30 min tasks
LanguageCompassionate, validatingDirect, efficient
ColorsCalming (blues/greens)Standard themes
Energy scaffoldingExplicit (spoons, breaks)Minimal

Accessibility Mode Features:

AspectColorblind-Safe ModeMonochrome Mode
Color usageRedundant (patterns + color)Pure B&W only (#000/#fff)
Border patternsDashed/dotted variationsSolid/dashed/dotted styles
Text labelsPrefixed ([KEEP], [DONATE])Verbose ([✓ KEEP], [? MAYBE])
Shape codingDiamond/hexagon/trapezoidDistinct geometric shapes
Fill patternsN/A (white fill, patterned borders)Solid/crosshatch/dots/white
Border thickness1-3px for hierarchy1-3px for hierarchy
SymbolsRedundant icons (✅ 📦 🤔)Text-based (✓ → ?)
Best forAll color vision typesB&W printing, e-ink displays
WCAG compliance2.1 AA (Use of Color 1.4.1)2.1 AAA (Maximum contrast)

Mode Combination Notes:

  • Base mode controls language, time estimates, and cognitive scaffolding
  • Accessibility mode controls visual encoding (patterns, contrast, shapes)
  • Both can be active simultaneously for maximum accommodation

Backward Compatibility

v3.1.1 maintains v3.0 behavior:

  • Defaults to neurodivergent base mode (v2.0 compatible)
  • Accessibility modes are opt-in (not enabled by default)
  • v3.0 visualizations remain valid (no breaking changes)

Mode Detection Algorithm

Step 1: Check for explicit base mode request

base_mode = None
accessibility_mode = None

# Detect base mode
if "neurotypical mode" in user_message.lower():
    base_mode = "neurotypical"
elif "adhd mode" or "neurodivergent mode" in user_message.lower():
    base_mode = "neurodivergent"

Step 2: Check for explicit accessibility mode request

# Detect colorblind-safe mode
colorblind_keywords = ["colorblind", "color blind", "colorblind-safe",
                      "colour blind", "accessible colors", "pattern-based",
                      "cvd", "color vision deficiency"]
if any(keyword in user_message.lower() for keyword in colorblind_keywords):
    accessibility_mode = "colorblind-safe"

# Detect monochrome mode (takes precedence over colorblind-safe)
monochrome_keywords = ["monochrome", "black and white", "b&w", "grayscale",
                      "greyscale", "print-friendly", "printing", "e-ink",
                      "black & white", "photocopier"]
if any(keyword in user_message.lower() for keyword in monochrome_keywords):
    accessibility_mode = "monochrome"

Step 3: Check configuration file

if config_file_exists():
    config = load_user_preference()

    # Apply base mode if not explicitly set
    if base_mode is None:
        base_mode = config.get("default_mode", "neurodivergent")

    # Apply accessibility mode if not explicitly set
    if accessibility_mode is None:
        accessibility_mode = config.get("colorblind_safe", False) and "colorblind-safe"
        if not accessibility_mode:
            accessibility_mode = config.get("monochrome", False) and "monochrome"

Step 4: Auto-detect base mode from language

distress_signals = ["overwhelmed", "paralyzed", "stuck", "can't decide",
                   "don't know where to start", "too much"]
neurodivergent_mentions = ["adhd", "autism", "executive dysfunction",
                          "time blindness", "decision paralysis"]
energy_mentions = ["spoons", "burned out", "exhausted", "no energy"]

if base_mode is None:
    if any(signal in user_message.lower() for signal in
           d
Read the complete source ↗