{"id":32784681,"url":"https://github.com/jackreis/neurodivergent-visual-org","last_synced_at":"2026-07-04T07:31:35.130Z","repository":{"id":322239930,"uuid":"1088556142","full_name":"JackReis/neurodivergent-visual-org","owner":"JackReis","description":"Visual organization tools for neurodivergent thinking - Claude Code skill with compassionate task breakdowns, decision trees, and focus support","archived":false,"fork":false,"pushed_at":"2025-11-03T10:27:22.000Z","size":110,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-03T12:15:14.065Z","etag":null,"topics":["accessibility","adhd","claude-code","executive-dysfunction","neurodivergent","productivity","superpowers","visual-organization"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JackReis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-03T06:08:32.000Z","updated_at":"2025-11-03T10:30:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/JackReis/neurodivergent-visual-org","commit_stats":null,"previous_names":["jackreis/neurodivergent-visual-org"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/JackReis/neurodivergent-visual-org","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JackReis%2Fneurodivergent-visual-org","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JackReis%2Fneurodivergent-visual-org/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JackReis%2Fneurodivergent-visual-org/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JackReis%2Fneurodivergent-visual-org/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JackReis","download_url":"https://codeload.github.com/JackReis/neurodivergent-visual-org/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JackReis%2Fneurodivergent-visual-org/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":282745088,"owners_count":26720200,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-05T02:00:05.946Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accessibility","adhd","claude-code","executive-dysfunction","neurodivergent","productivity","superpowers","visual-organization"],"created_at":"2025-11-05T02:00:45.437Z","updated_at":"2026-07-04T07:31:35.124Z","avatar_url":"https://github.com/JackReis.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"---\ncreated: 2025-11-02T22:59\nupdated: 2025-11-10T18:00\n---\n# Neurodivergent Visual Organization Skill v3.1.1\n\nCreate ADHD-friendly visual organizational tools using Mermaid diagrams with adaptive cognitive modes and accessibility features.\n\n## What's New in v3.1.1\n\n### Latest Updates\n\n- **Generalized Examples**: Replaced context-specific examples with universal decision-making patterns for broader applicability\n- **Accessibility Modes**: Colorblind-safe and monochrome modes for inclusive design\n- **URL Encoding Fix**: Proper handling of HTML entities in Mermaid playground links\n\n## Core Features\n\n### 1. **Adaptive Mode System**\n   - **Base Modes**: Neurotypical or Neurodivergent cognitive styles\n   - **Accessibility Modes**: Optional colorblind-safe or monochrome overlays\n   - **Auto-Detection**: Analyzes language for optimal mode selection\n   - **Configuration Support**: Personalize defaults via YAML config\n\n### 2. **Dual Template System**\n   - **Neurotypical**: 5-7 chunks, standard times, efficient layout\n   - **Neurodivergent**: 3-5 chunks, buffered times, compassionate language\n   - Mode-specific color schemes and energy scaffolding\n\n### 3. **Accessibility First**\n   - **Colorblind-Safe**: Pattern-based differentiation for all color vision types\n   - **Monochrome**: Print-optimized B\u0026W designs for e-ink displays\n   - **WCAG Compliance**: Meets accessibility standards\n\n4. **Inclusive Design**\n   - Neurotypical users benefit during stress/burnout\n   - Teams can use same tool with different modes\n   - Educational: demonstrates cognitive accessibility\n   - Backward compatible (defaults to neurodivergent)\n\n## Mode Quick Reference\n\n| Need | Recommended Mode |\n|------|------------------|\n| Personal task overwhelm | Neurodivergent (auto-detects) |\n| Team presentation | Neurotypical (request explicitly) |\n| Executive dysfunction support | Neurodivergent |\n| Standard project planning | Neurotypical |\n| Mixed team collaboration | Auto-detect (adapts per person) |\n| Stress/burnout (any neurotype) | Neurodivergent |\n\n## Installation\n\n### Option 1: Via Marketplace (Recommended)\n\nIn Claude Code, run:\n```\n/plugin marketplace add JackReis/neurodivergent-visual-org\n```\n\nThen browse and install via the `/plugin` menu.\n\n### Option 2: From GitHub\n\n```bash\ncd ~/.claude/plugins/\ngit clone https://github.com/JackReis/neurodivergent-visual-org.git\n```\n\nRestart Claude Code.\n\n### Option 3: Manual Download\n\n1. Download the latest release from GitHub\n2. Extract to `~/.claude/plugins/neurodivergent-visual-org/`\n3. Restart Claude Code\n\n### For Claude.ai Desktop (MCP Skills)\n\n1. Locate your skills directory (usually `~/Library/Application Support/Claude/skills/user/`)\n2. Copy the `skills/neurodivergent-visual-org/` folder to:\n   - `~/Library/Application Support/Claude/skills/user/neurodivergent-visual-org/`\n3. Restart Claude.ai Desktop app\n\n## Configuring Your Mode\n\n### Auto-Detect (Default)\n\nThe skill automatically chooses the best mode based on your language:\n- Distress signals → Neurodivergent mode\n- Straightforward requests → Neurotypical mode\n- Ambiguous → Neurodivergent mode (inclusive default)\n\n### Explicit Mode Request\n\nIn conversation:\n```\n\"Use neurotypical mode for this diagram\"\n\"Switch to ADHD mode\"\n\"Make it more detailed\" (switches to neurodivergent)\n\"Make it more compact\" (switches to neurotypical)\n```\n\n### Set Default Mode\n\nCreate: `.claude/neurodivergent-visual-org-preference.yml`\n\n```yaml\nmode: auto-detect  # Options: neurotypical, neurodivergent, auto-detect\ntime_buffer_multiplier: 1.5  # For neurodivergent: 1.5-2.0\nchunk_size_max: 5  # Max items per section\ncolor_scheme: calming  # Options: calming, standard\n```\n\n## Package Contents\n\n```\nneurodivergent-visual-org-v3/\n├── SKILL.md                          # Main skill file with mode detection\n├── README.md                         # This file\n├── config/                           # Mode configuration\n│   ├── modes.md                      # Mode definitions\n│   └── user-preference.md            # Configuration guide\n├── templates/                        # Template libraries\n│   ├── neurodivergent/               # ADHD-optimized (v2.0 patterns)\n│   │   ├── task-breakdown.md\n│   │   ├── decision-tree.md\n│   │   ├── project-map.md\n│   │   ├── current-state.md\n│   │   ├── time-boxing.md\n│   │   ├── habit-building.md\n│   │   ├── accountability.md\n│   │   └── focus-regulation.md\n│   └── neurotypical/                 # Professional templates\n│       ├── task-breakdown.md\n│       ├── decision-tree.md\n│       └── project-map.md\n├── examples/                         # Mode comparison examples\n│   └── mode-comparison.md\n└── tests/                            # Test scenarios\n    └── test_mode_detection.md\n```\n\n## Quick Start\n\nThe skill activates when users:\n- Feel overwhelmed by tasks\n- Experience decision paralysis\n- Need to break down complex projects\n- Struggle with time blindness\n- Want to track habits or energy\n- Need visual organization tools\n- Request professional presentations\n\n### Example Usage\n\n**User:** \"I need to clean my apartment but it's so messy I don't know where to start\"\n\n**Skill Response:**\n1. Auto-detects neurodivergent mode (keywords: \"so messy\", \"don't know where to start\")\n2. Creates flowchart or timeline breaking cleaning into 10-15 minute chunks\n3. Starts with \"quick wins\" for visible progress\n4. Uses calming color theme\n5. Includes validation and encouragement\n6. Renders with Mermaid tool\n7. Offers to save to Obsidian\n\n## Key Principles\n\n### Neurodivergent Mode\n- **Compassionate language** (never \"just\" or \"should\")\n- **Realistic time estimates** (1.5-2x normal estimates)\n- **Energy awareness** (acknowledge spoon theory)\n- **Micro-steps** (3-10 minute tasks)\n- **Permission statements** (combat perfectionism)\n- **Celebrate starting** (not just finishing)\n- **3-5 information chunks** per section (working memory)\n- **Calming colors** (blues, greens, muted tones)\n\n### Neurotypical Mode\n- **Direct language** (efficient, professional)\n- **Standard time estimates** (no buffer)\n- **Standard tasks** (15-30 minute blocks)\n- **Professional presentation** (stakeholder-ready)\n- **5-7 information chunks** per section (Miller's Law)\n- **Standard color schemes** (Mermaid defaults)\n\n## Mermaid Quick Reference\n\n### Most Useful Diagram Types for ADHD\n\n| Need | Diagram Type |\n|------|--------------|\n| \"I don't know where to start\" | Flowchart (decision tree) |\n| \"This is overwhelming\" | Timeline or Gantt chart |\n| \"I can't decide\" | Quadrant chart (Eisenhower Matrix) |\n| \"What should I focus on?\" | Quadrant chart or Pie chart |\n| \"Time disappears\" | Timeline (make time visible) |\n| \"No energy\" | Pie or Sankey (spoon theory) |\n| \"Build a habit\" | Flowchart or User journey |\n\n### Cognitive Load Limits\n\n**Neurodivergent Mode:**\n- **Flowcharts**: 12-15 nodes maximum\n- **Mindmaps**: 2-3 levels deep\n- **Pie charts**: 4-6 slices\n- **Lists**: 2 lists × 3-5 items max\n- **Sections**: 3-5 per diagram\n\n**Neurotypical Mode:**\n- **Flowcharts**: 20-25 nodes maximum\n- **Mindmaps**: 4-5 levels deep\n- **Pie charts**: 6-8 slices\n- **Lists**: 2 lists × 5-7 items max\n- **Sections**: 5-7 per diagram\n\n### Recommended Themes\n\n**Neurodivergent Mode:**\n- `forest` - Calming green-based\n- `neutral` - Muted earth tones\n- Both reduce visual overstimulation\n\n**Neurotypical Mode:**\n- `default` - Standard Mermaid theme\n- Any professional color scheme\n\n## Troubleshooting\n\n### Common Issues\n\n**Diagram won't render**\n- Check indentation consistency (mindmaps, composites)\n- Avoid lowercase \"end\" as state name (use \"End\" or \"END\")\n- Verify coordinates are 0-1 for quadrant charts\n- Remove `::icon()` syntax for GitHub compatibility\n\n**Colors not working**\n- Use YAML frontmatter for Sankey config (not directives)\n- Remember pie chart colors assigned by size, not order\n\n**Events missing in timeline**\n- All events before first `section` are ignored\n- Add section before any timeline events\n\n**Mode not detected correctly**\n- Use explicit mode request: \"Use neurotypical mode\"\n- Check configuration file syntax\n- See test scenarios in `tests/test_mode_detection.md`\n\n## Support \u0026 Resources\n\n- **Reddit r/ADHD** - Community-shared patterns\n- **ADDitude Magazine** - Research-backed strategies\n- **CHADD** - Evidence-based resources\n- **Mermaid Live Editor** - mermaid.live for testing\n- **GitHub Repository** - Issues and discussions\n\n## Version History\n\n- **v3.0** - Neurotypical/neurodivergent mode toggle, dual template system, auto-detection\n- **v2.0** - Comprehensive Mermaid syntax, research-backed design, troubleshooting\n- **v1.0** - Initial release with basic patterns\n\n## License\n\nThis skill incorporates research from neuroscience, cognitive psychology, and ADHD communities. Use freely and adapt to your needs.\n\n---\n\n**Remember**: Visual tools work WITH brain differences, not against them. These diagrams externalize executive function and make the invisible visible. Choose the mode that helps you right now.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackreis%2Fneurodivergent-visual-org","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjackreis%2Fneurodivergent-visual-org","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackreis%2Fneurodivergent-visual-org/lists"}