Neurodivergent Visual Org

--- created: 2025-11-02T22:59 updated: 2025-11-10T18:00 ---

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

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

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/

1. 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
…

Quick Start

The skill activates when users:

• Feel overwhelmed by tasks
• Experience decision paralysis
• Need to break down complex projects
• Struggle with time blindness
• Want to track habits or energy
• Need visual organization tools
• Request professional presentations

Example Usage

User: "I need to clean my apartment but it's so messy I don't know where to start"

Skill Response:

1. Auto-detects neurodivergent mode (keywords: "so messy", "don't know where to start")
2. Creates flowchart or timeline breaking cleaning into 10-15 minute chunks
3. Starts with "quick wins" for visible progress
4. Uses calming color theme
5. Includes validation and encouragement
6. Renders with Mermaid tool
7. Offers to save to Obsidian

Key Principles

Neurodivergent Mode

• Compassionate language (never "just" or "should")
• Realistic time estimates (1.5-2x normal estimates)
• Energy awareness (acknowledge spoon theory)