neurodivergent-visual-org

Neurodivergent Visual Organization Skill v3.1.1

Create ADHD-friendly visual organizational tools using Mermaid diagrams with adaptive cognitive modes and accessibility features.

What's New in v3.1.1

Latest Updates

• Generalized Examples: Replaced context-specific examples with universal decision-making patterns for broader applicability
• Accessibility Modes: Colorblind-safe and monochrome modes for inclusive design
• URL Encoding Fix: Proper handling of HTML entities in Mermaid playground links

Core Features

1. Adaptive Mode System

• Base Modes: Neurotypical or Neurodivergent cognitive styles
• Accessibility Modes: Optional colorblind-safe or monochrome overlays
• Auto-Detection: Analyzes language for optimal mode selection
• Configuration Support: Personalize defaults via YAML config

2. Dual Template System

• Neurotypical: 5-7 chunks, standard times, efficient layout
• Neurodivergent: 3-5 chunks, buffered times, compassionate language
• Mode-specific color schemes and energy scaffolding

3. Accessibility First

• Colorblind-Safe: Pattern-based differentiation for all color vision types
• Monochrome: Print-optimized B&W designs for e-ink displays
• WCAG Compliance: Meets accessibility standards

4. Inclusive Design
   • Neurotypical users benefit during stress/burnout
   • Teams can use same tool with different modes
   • Educational: demonstrates cognitive accessibility
   • Backward compatible (defaults to neurodivergent)

Mode Quick Reference

Need	Recommended Mode
Personal task overwhelm	Neurodivergent (auto-detects)
Team presentation	Neurotypical (request explicitly)
Executive dysfunction support	Neurodivergent
Standard project planning	Neurotypical
Mixed team collaboration	Auto-detect (adapts per person)
Stress/burnout (any neurotype)	Neurodivergent

Installation

Option 1: Via Marketplace (Recommended)

In Claude Code, run:

/plugin marketplace add JackReis/neurodivergent-visual-org

Then browse and install via the /plugin menu.

Option 2: From GitHub

cd ~/.claude/plugins/
git clone https://github.com/JackReis/neurodivergent-visual-org.git

Restart Claude Code.

Option 3: Manual Download

1. Download the latest release from GitHub
2. Extract to ~/.claude/plugins/neurodivergent-visual-org/
3. Restart Claude Code

For Claude.ai Desktop (MCP Skills)

1. Locate your skills directory (usually ~/Library/Application Support/Claude/skills/user/)
2. Copy the skills/neurodivergent-visual-org/ folder to:
   • ~/Library/Application Support/Claude/skills/user/neurodivergent-visual-org/
3. Restart Claude.ai Desktop app

Configuring Your Mode

Auto-Detect (Default)

The skill automatically chooses the best mode based on your language:

• Distress signals → Neurodivergent mode
• Straightforward requests → Neurotypical mode
• Ambiguous → Neurodivergent mode (inclusive default)

Explicit Mode Request

In conversation:

"Use neurotypical mode for this diagram"
"Switch to ADHD mode"
"Make it more detailed" (switches to neurodivergent)
"Make it more compact" (switches to neurotypical)

Set Default Mode

Create: .claude/neurodivergent-visual-org-preference.yml

mode: auto-detect  # Options: neurotypical, neurodivergent, auto-detect
time_buffer_multiplier: 1.5  # For neurodivergent: 1.5-2.0
chunk_size_max: 5  # Max items per section
color_scheme: calming  # Options: calming, standard

Package Contents

neurodivergent-visual-org-v3/
├── SKILL.md                          # Main skill file with mode detection
├── README.md                         # This file
├── config/                           # Mode configuration
│   ├── modes.md                      # Mode definitions
│   └── user-preference.md            # Configuration guide
├── templates/                        # Template libraries
│   ├── neurodivergent/               # ADHD-optimized (v2.0 patterns)
│   │   ├── task-breakdown.md
│   │   ├── decision-tree.md
│   │   ├── project-map.md
│   │   ├── current-state.md
│   │   ├── time-boxing.md
│   │   ├── habit-building.md
│   │   ├── accountability.md
│   │   └── focus-regulation.md
│   └── neurotypical/                 # Professional templates
│       ├── task-breakdown.md
│       ├── decision-tree.md
│       └── project-map.md
├── examples/                         # Mode comparison examples
│   └── mode-comparison.md
└── tests/                            # Test scenarios
    └── test_mode_detection.md

Quick Start