I Have Adhd
TanStack/ai
A skill your agent uses when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output.
Agent skill
Neurodivergent Visual Org
by jeremylongshore in jeremylongshore/tons-of-skills-marketplace
Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns.
Install Neurodivergent Visual Org
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace neurodivergent-visual-org --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/neurodivergent-visual-org .claude/skills/neurodivergent-visual-org && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "neurodivergent-visual-org" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/neurodivergent-visual-org into .claude/skills/neurodivergent-visual-org/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "neurodivergent-visual-org", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/neurodivergent-visual-orgType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace neurodivergent-visual-org --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/.curated/neurodivergent-visual-org .agents/skills/neurodivergent-visual-org && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "neurodivergent-visual-org" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/neurodivergent-visual-org into .agents/skills/neurodivergent-visual-org/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "neurodivergent-visual-org", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace neurodivergent-visual-org --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/.curated/neurodivergent-visual-org .cursor/skills/neurodivergent-visual-org && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "neurodivergent-visual-org" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/neurodivergent-visual-org into .cursor/skills/neurodivergent-visual-org/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "neurodivergent-visual-org", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace.git --path skills/.curated/neurodivergent-visual-org--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace neurodivergent-visual-org --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/.curated/neurodivergent-visual-org .gemini/skills/neurodivergent-visual-org && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "neurodivergent-visual-org" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/neurodivergent-visual-org into .gemini/skills/neurodivergent-visual-org/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "neurodivergent-visual-org", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install jeremylongshore/tons-of-skills-marketplace neurodivergent-visual-orgInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/.curated/neurodivergent-visual-org .github/skills/neurodivergent-visual-org && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "neurodivergent-visual-org" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/neurodivergent-visual-org into .github/skills/neurodivergent-visual-org/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "neurodivergent-visual-org", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install jeremylongshore/tons-of-skills-marketplace neurodivergent-visual-org --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/.curated/neurodivergent-visual-org .opencode/skills/neurodivergent-visual-org && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "neurodivergent-visual-org" agent skill from https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/main/skills/.curated/neurodivergent-visual-org into .opencode/skills/neurodivergent-visual-org/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "neurodivergent-visual-org", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
neurodivergent-visual-org- GitHub stars
- 2.8k
- Token cost
- ~5k tokens
- SKILL.md length
- 2,182 words
- Files
- 4 (incl. references)
- Skills in repo
- 3,342
- Repo updated
- First seen
- Licence
- MIT
At a glance
Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns.
- Works in 3 steps: Auto-Detect (Default) → Explicit Mode Request → Configuration File
- Creating visual task breakdowns
- SKILL.md covers Mode System (v3.1.1), Mode Detection Algorithm, Accessibility Mode… and Configuration File Schema, plus 8 more sections
- Reaches mermaid.live
What it does
Neurodivergent Visual Org is an agent skill from jeremylongshore/tons-of-skills-marketplace. 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. Use when creating visual task breakdowns, decision trees, or organizational diagrams for neurodivergent users or accessibility-focused projects. Trigger with 'neurodivergent', 'visual', 'org'.
Its SKILL.md is about 5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/accessibility-modes.md`, `references/configuration-schema.md` and `references/mode-detection-algorithm.md`). Compatibility notes: Designed for Claude Code
It sits in Productivity & Automation, covering Focus and ADHD support. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.
When your agent uses it
- Creating visual task breakdowns
- Organizational diagrams for neurodivergent users
- Accessibility-focused projects
- With neurodivergent
Example prompts
- “neurodivergent”
- “visual”
- “Use the neurodivergent-visual-org skill to create ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent…”
- “/neurodivergent-visual-org”
Requirements
- Compatibility (from SKILL.md): Designed for Claude Code
- Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Glob, Bash(cmd:*)
Workflow steps
3 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadWriteEditGrepGlobBash(cmd:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are python and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
mermaid.live
Also links to:
mermaid.js.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Designed for Claude Code
From compatibility in the SKILL.md frontmatter.
Context cost
Neurodivergent Visual Org loads about 5k tokens when it runs, and up to ~8.3k if it reads all its reference files. Until then it costs about 108 tokens; SKILL.md has 2,182 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 2,182 words, ~5,033 tokens.
Download SKILL.mdSave it as
.claude/skills/neurodivergent-visual-org/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.- 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. Use when creating visual task breakdowns, decision trees, or organizational diagrams for neurodivergent users or accessibility-focused projects. Trigger with 'neurodivergent', 'visual', 'org'.
- allowed-tools
- Read, Write, Edit, Grep, Glob, Bash(cmd:*)
- compatibility
- Designed for Claude Code
- version
- 3.10.0
- author
- Jack Reis <hello@jack.digital>
- license
- MIT
- tags
- productivity, neurodivergent-visual
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):
- Neurodivergent Mode - ADHD-friendly, energy-aware, compassionate language
- 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:
| Aspect | Neurodivergent Mode | Neurotypical Mode |
|---|---|---|
| Chunk size | 3-5 items | 5-7 items |
| Time estimates | 1.5-2x with buffer | Standard |
| Task granularity | 3-10 min micro-steps | 15-30 min tasks |
| Language | Compassionate, validating | Direct, efficient |
| Colors | Calming (blues/greens) | Standard themes |
| Energy scaffolding | Explicit (spoons, breaks) | Minimal |
Accessibility Mode Features:
| Aspect | Colorblind-Safe Mode | Monochrome Mode |
|---|---|---|
| Color usage | Redundant (patterns + color) | Pure B&W only (#000/#fff) |
| Border patterns | Dashed/dotted variations | Solid/dashed/dotted styles |
| Text labels | Prefixed ([KEEP], [DONATE]) | Verbose ([✓ KEEP], [? MAYBE]) |
| Shape coding | Diamond/hexagon/trapezoid | Distinct geometric shapes |
| Fill patterns | N/A (white fill, patterned borders) | Solid/crosshatch/dots/white |
| Border thickness | 1-3px for hierarchy | 1-3px for hierarchy |
| Symbols | Redundant icons (✅ 📦 🤔) | Text-based (✓ → ?) |
| Best for | All color vision types | B&W printing, e-ink displays |
| WCAG compliance | 2.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
See references/mode-detection-algorithm.md for the full 6-step detection pseudocode covering explicit requests, config file lookup, auto-detection from language signals, and defaults.
Accessibility Mode Implementation
See references/accessibility-modes.md for complete specifications including:
- Colorblind-safe mode: border patterns, shape coding, text prefixes, color strategy
- Monochrome mode: fill patterns, border styles, verbose labels, spacing
- Mode combination logic and combined output examples
Configuration File Schema
Users can create .claude/neurodivergent-visual-org-preference.yml to set default modes and customize behavior. See references/configuration-schema.md for the complete schema, examples, and precedence rules.
Neurodivergent Visual Organization
Create visual organizational tools that make invisible work visible and reduce cognitive overwhelm. This skill generates Mermaid diagrams optimized for neurodivergent thinking patterns, leveraging research-backed design principles that work WITH ADHD brain wiring rather than against it.
Why Visual Tools Work for ADHD Brains
Visual aids externalize executive function by:
- Converting abstract concepts (time, energy, priorities) into concrete visual formats
- Reducing working memory load by moving information from internal to external scaffolding
- Combating "out of sight, out of mind" through persistent visual presence
- Leveraging visual-spatial strengths while compensating for working memory deficits
- Providing immediate feedback that ADHD brains need for sustained engagement
- Making time tangible to address time blindness (a core ADHD deficit)
Research shows altered early sensory processing in ADHD (P1 component deficits), making thoughtful visual design critical for reducing sensory load and improving focus.
When to Use This Skill
Use when the user:
- Feels overwhelmed by a task or project ("I don't know where to start")
- Needs to break down something complex into steps
- Is stuck making a decision or mentions analysis paralysis
- Asks "what should I focus on?" or "what's on my plate?"
- Mentions executive dysfunction, time blindness, or decision fatigue
- Wants to see how tasks connect or depend on each other
- Needs to track progress across multiple things
- Says something feels "too big" or "too much"
- Requests help with routines, habits, or time management
- Needs energy tracking or spoon theory visualization
- Wants to understand system states or process flows
Core Principles
Always apply these neurodivergent-friendly principles:
- Use compassionate, non-judgmental language (never "just do it" or "should be easy")
- Give realistic time estimates with buffer (use 1.5-2x what seems reasonable)
- Acknowledge energy costs, not just time (consider spoon theory)
- Break tasks into 3-10 minute micro-steps (smaller than you think)
- Include "you can modify this" permission statements (combat perfectionism)
- Celebrate starting, not just finishing (task initiation is a real achievement)
- Make "done" concrete and achievable (vague goals create paralysis)
- Show progress, not just what's left (focus on accomplishments)
- Limit information to 3-5 chunks per section (working memory constraint)
- Use calming color palettes (blues, greens, muted tones)
- Provide generous white space (reduce visual overwhelm)
- Create clear visual hierarchy (size, color, contrast)
Neurodivergent-Friendly Design Standards
Color Psychology for ADHD
Primary Palette (Use These)
- Blues and greens in soft, muted tones - promote tranquility and focus
- Muted browns - provide grounding without stimulation
- Soft pastels (light blues, lavenders, pale greens) - reduce visual stress
- Muted yellows (sparingly) - boost energy without overstimulation
Avoid
- Bright reds, oranges, intense yellows - increase hyperactivity/agitation
- Bright saturated colors - cause sensory overload
- Clashing color combinations - create visual stress
Implementation
- Use
foresttheme (green-based) orneutraltheme (muted earth tones) - Apply 60-30-10 rule: 60% calming background, 30% secondary, 10% accent
- Maintain 4.5:1 contrast ratio minimum (WCAG compliance)
- Never rely on color alone - pair with icons, patterns, or text labels
Information Density Management
Miller's Law + ADHD Considerations
- Working memory holds 5-7 chunks (neurotypical) or 3-5 chunks (ADHD)
- Stay at lower end (3-5 chunks) to prevent cognitive overload
- Increased cognitive load reduces ADHD performance more severely
Practical Limits
- Flowcharts: 15-20 nodes maximum before splitting into multiple diagrams
- Mindmaps: 3-4 levels deep maximum
- Pie charts: 6-8 slices for readability
- Lists: No more than 2 lists of 3-5 items per diagram
- Sections: Use timeline/journey sections to chunk events logically
Implementation
- Break complex diagrams into digestible sections
- Use progressive disclosure (show relevant info upfront, details on demand)
- Provide TL;DR sections at beginning of complex diagrams
- Include generous white space between elements
Visual Hierarchy Principles
Size Contrast (must be dramatic for ADHD attention)
- H1 significantly larger than H2, which is notably larger than body text
- Important nodes visibly larger than standard nodes
- Use
classDefto style critical elements distinctly
Priority Signaling
- Distinguish important information through bold or color
- Use visual highlights for critical numbers or elements
- Separate each instruction clearly
- Implement color-coded systems for immediate visual feedback
Avoid
- Competing visual elements fighting for attention
- Auto-playing animations or flashy effects (extremely distracting)
- Blinking or flashing elements
- More than 2 fonts per diagram
Comprehensive Mermaid Diagram Selection Guide
Mermaid 11.12.1 offers 22 diagram types. Choose based on cognitive need:
Executive Function & Task Management
| User Need | Best Diagram Type | When to Use |
|---|---|---|
| "I don't know where to start" | Flowchart (decision tree) | Diagnose task initiation blocks |
| "This task is overwhelming" | Gantt chart or Timeline | Break into sequential phases with time |
| "How are tasks connected?" | Flowchart (dependencies) | Show prerequisite relationships |
| "What's the order of operations?" | Timeline or State diagram | Sequential progression with states |
| "Track project phases" | Gantt chart | Complex projects with dependencies |
Decision-Making & Prioritization
| User Need | Best Diagram Type | When to Use |
|---|---|---|
| "I can't decide between options" | Quadrant chart | 2-dimensional comparison (Eisenhower Matrix) |
| "Need to weigh factors" | Flowchart (decision tree) | Branching logic with validation |
| "What should I focus on first?" | Quadrant chart | Urgent/Important matrix |
| "Too many things on my plate" | Pie chart | Visualize proportional allocation |
| "Comparing multiple aspects" | User journey | Track satisfaction across dimensions |
Organization & Current State
| User Need | Best Diagram Type | When to Use |
|---|---|---|
| "What's on my plate?" | Kanban (if available) | Track To Do/Doing/Done states |
| "Show task status" | State diagram | Visualize item states and transitions |
| "Organize by category" | Mindmap | Non-linear brainstorming and categorization |
| "See the big picture" | Mindmap | Hierarchical overview of complex topic |
| "Track multiple projects" | Gantt chart | Parallel timelines with milestones |
Show full SKILL.md (861 more words)Show less
Time & Energy Management
| User Need | Best Diagram Type | When to Use |
|---|---|---|
| "Make time visible" | Timeline with sections | Combat time blindness with visual periods |
| "Plan my day/week" | Gantt chart | Time-blocked schedule with buffer |
| "Track energy patterns" | Pie chart or XY chart | Spoon theory visualization |
| "Pomodoro planning" | Timeline | Show focus/break cycles visually |
| "Energy allocation" | Sankey diagram | Show energy flow across activities |
Habits & Routines
| User Need | Best Diagram Type | When to Use |
|---|---|---|
| "Build a morning routine" | Flowchart or Timeline | Sequential steps with time estimates |
| "Habit stacking" | Flowchart | Show trigger → action chains |
| "Track habit progress" | User journey | Satisfaction scores across habit stages |
| "Visual routine chart" | Timeline with sections | Color-coded daily schedule |
Systems & Processes
| User Need | Best Diagram Type | When to Use |
|---|---|---|
| "How does this system work?" | State diagram | Show system states and transitions |
| "Process flow" | Flowchart | Step-by-step procedures |
| "Data/resource flow" | Sankey diagram | Visualize flow and distribution |
| "Relationships between entities" | ER diagram or Mindmap | Show connections and structure |
| "Architecture/structure" | Architecture diagram (beta) | System components with icons |
Detailed Syntax Guide for Priority Types
[Content continues with all the detailed syntax guides, troubleshooting, workflow sections, etc. from the original SKILL.md - truncating here to stay within reasonable length]
Playground Links and URL Encoding
When providing links to edit Mermaid diagrams in online playgrounds (like https://mermaid.live), you MUST properly URL-encode the diagram content, especially HTML entities like <br/> tags.
Common Issue: Broken <br/> Tags
Mermaid diagrams use <br/> for line breaks in node text. These MUST be encoded properly in URLs.
❌ BROKEN (angle brackets not encoded):
https://mermaid.live/edit#pako:flowchart TD
Start{Can decide<br/>in 3 seconds?}✅ CORRECT (all characters properly encoded):
https://mermaid.live/edit#pako:flowchart%20TD%0A%20%20%20%20Start%7BCan%20decide%3Cbr%2F%3Ein%203%20seconds%3F%7DURL Encoding Rules
IMPORTANT: Despite earlier claims that "Mermaid 11.12.1+ fixed <br/> encoding", URL encoding is STILL REQUIRED for playground links to work correctly.
Use Python's urllib.parse.quote() with safe='' to encode ALL special characters:
import urllib.parse
diagram = """flowchart TD
Start{Can decide<br/>in 3 seconds?}"""
encoded = urllib.parse.quote(diagram, safe='')
url = f"https://mermaid.live/edit#pako:{encoded}"Key encodings:
<→%3C>→%3E/→%2F- Space →
%20 - Newline →
%0A {→%7B}→%7D
When Providing Playground Links
Always include properly encoded playground links in your diagram output:
## 🎯 Master Decision Flowchart
[🎨 Edit in Playground](https://mermaid.live/edit#pako:{PROPERLY_ENCODED_DIAGRAM})
\`\`\`mermaid
{DIAGRAM_CODE}
\`\`\`This allows users to:
- View rendered diagrams online
- Edit and customize diagrams
- Share diagrams with collaborators
- Access diagrams on mobile devices
Testing Links
Before providing a playground link, verify that:
- The URL opens without errors
- The diagram renders correctly
- All
<br/>tags display as line breaks (not literal<br/>text)
If angle brackets appear as literal text in the rendered diagram, the URL encoding is broken.
Version History
- v3.1.1 (Current): Fixed URL encoding documentation error. Mermaid playground links STILL require proper encoding of HTML entities like
<br/>tags. All previous features plus corrected documentation. - v3.1: Added colorblind-safe and monochrome accessibility modes with pattern-based differentiation. Mode system supports neurodivergent/neurotypical base modes combined with optional accessibility modes. Configuration file support for personalized defaults.
- v3.0: Mode system (neurodivergent/neurotypical/auto-detect), configuration file support, enhanced accessibility features
- v2.0: Comprehensive Mermaid 11.12.1 syntax, research-backed neurodivergent design principles, troubleshooting guide, expanded diagram types
- v1.0: Initial release with basic patterns and reference files
Quick Reference Card
When user says... → Use this diagram type
- "I don't know where to start" → Flowchart (decision tree)
- "This is overwhelming" → Timeline or Gantt (break into phases)
- "I can't decide" → Quadrant chart (Eisenhower Matrix)
- "What should I focus on?" → Quadrant chart or Pie chart
- "Too many things" → Kanban or State diagram
- "Time disappears" → Timeline (make time visible)
- "No energy" → Pie or Sankey (spoon theory)
- "How does this work?" → State diagram or Flowchart
- "Build a habit" → Flowchart (habit stacking) or User journey
- "Plan my day" → Timeline or Gantt (time-blocked)
Always:
✅ Use calming colors (forest/neutral theme)
✅ Limit to 3-5 chunks per section
✅ Be compassionate and realistic
✅ Validate with Mermaid tool
✅ Provide usage instructions
✅ Offer to save to Obsidian
✅ Properly URL-encode playground links (REQUIRED for <br/> tags)
Never:
❌ Judgmental language ("just" or "should")
❌ Unrealistic time estimates
❌ Too many nodes/elements
❌ Bright clashing colors
❌ Skip encouragement and validation
❌ Provide unencoded playground links with <br/> tags
Overview
Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns, with colorblind-safe and monochrome accessibility modes.
Prerequisites
- Mermaid rendering support (Obsidian, GitHub, VS Code, or mermaid.live)
- No CLI tools required — all output is Mermaid diagram code
Instructions
- Detect mode: check for explicit request, then config file, then auto-detect from language signals (see mode detection algorithm)
- Choose diagram type from the Comprehensive Mermaid Diagram Selection Guide based on user need
- Apply neurodivergent-friendly design standards (3-5 chunks, calming colors, compassionate language)
- Generate Mermaid diagram with properly URL-encoded playground links
Output
- Mermaid diagram code block ready for rendering
- Playground link for editing at mermaid.live (properly URL-encoded)
- Brief usage instructions calibrated to user's cognitive mode
Error Handling
| Error | Cause | Resolution |
|---|---|---|
| Mermaid syntax error | Invalid node or style definition | Validate against Mermaid 11.12.1 syntax; check for unescaped special characters |
| Broken playground link | <br/> tags not URL-encoded | Encode all HTML entities: < as %3C, > as %3E, / as %2F |
| Diagram too complex | Exceeds 15-20 nodes | Split into multiple diagrams with clear section labels |
Examples
- Task overwhelm: User says "I don't know where to start" — generate a flowchart decision tree breaking the task into 3-5 minute micro-steps with energy cost labels.
- Decision paralysis: User says "I can't decide" — generate a quadrant chart (Eisenhower Matrix) sorting options by urgency and importance.
Resources
- references/mode-detection-algorithm.md — 6-step mode detection pseudocode
- references/accessibility-modes.md — colorblind-safe and monochrome specifications
- references/configuration-schema.md — user preference file schema and examples
- Mermaid documentation — official syntax reference
© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 3 other files (references) in skills/.curated/neurodivergent-visual-org of jeremylongshore/tons-of-skills-marketplace.
- SKILL.md
- references/accessibility-modes.md
- references/configuration-schema.md
- references/mode-detection-algorithm.md
Open the folder on GitHubat commit cfae287
Compare with similar skills
Neurodivergent Visual Org next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Neurodivergent Visual Org this skilljeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~5k | Automated safety check: Pass | MIT | |
| I Have AdhdTanStack/ai | 3.2k | 5 repos | ~1.8k | Automated safety check: Pass | MIT | |
| Attention Kindalexgreensh/attention-span | 1.4k | — | ~2k | Automated safety check: Pass | AGPL-3.0 | |
| Remind Meshaheer-00/claude-adhd | 105 | — | ~1.1k | Automated safety check: Pass | None | |
| Daily Focus Boardgithub/awesome-copilot | 40k | — | ~3k | Automated safety check: Pass | MIT | |
| Attention Controlaaddrick/attention-control | 119 | — | ~3.6k | Automated safety check: Pass | MIT |
Similar skills
Attention Kind
alexgreensh/attention-span
Answer in the ADHD-friendly Attention-kind style for the rest of this chat.
Remind Me
shaheer-00/claude-adhd
Surface unfinished or forgotten tasks, ideas, and open questions from the user's past Claude Code sessions, manage custom reminders, run focus sessions, and match tasks to the user's energy.
- Official
Daily Focus Board
github/awesome-copilot
Builds a warm, browser-based daily focus board the user updates by talking to their agent, with Eisenhower priorities, a brain-dump box and kind not-today carryover.
Attention Control
aaddrick/attention-control
Shape output for a reader with ADHD, then write each sentence in controlled English: action first, one word one meaning, active voice, simple tenses, state restated every turn.
Chief Of Staff
jdpolasky/ai-chief-of-staff
Personal Chief of Staff system for ADHD-ish operators. An agent skill from jdpolasky/ai-chief-of-staff.
More from jeremylongshore/tons-of-skills-marketplace
All 3,342 skills in this repoPerforming Security Code Review
jeremylongshore/tons-of-skills-marketplace
Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.
Adapting Transfer Learning Models
jeremylongshore/tons-of-skills-marketplace
Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.
Agent Context Loader
jeremylongshore/tons-of-skills-marketplace
Execute proactive auto-loading: automatically detects and loads agents.md files.
Aggregating Performance Metrics
jeremylongshore/tons-of-skills-marketplace
Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.
Analyzing Capacity Planning
jeremylongshore/tons-of-skills-marketplace
Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.
Analyzing Database Indexes
jeremylongshore/tons-of-skills-marketplace
Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.
Related
Categories
Questions about Neurodivergent Visual Org
What does Neurodivergent Visual Org do?
Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns. Neurodivergent Visual Org is an agent skill from jeremylongshore/tons-of-skills-marketplace. Creates ADHD-friendly visual organizational tools using Mermaid diagrams optimized for neurodivergent thinking patterns.
When should I use Neurodivergent Visual Org?
Neurodivergent Visual Org fits situations like: creating visual task breakdowns; organizational diagrams for neurodivergent users; accessibility-focused projects; with neurodivergent.
How do I install Neurodivergent Visual Org in Claude Code?
Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a claude-code`. Or copy the skill folder (skills/.curated/neurodivergent-visual-org in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/neurodivergent-visual-org in your project. Claude Code loads it when a task matches its description.
How do I install Neurodivergent Visual Org in Codex?
Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a codex`. Or copy the skill folder (skills/.curated/neurodivergent-visual-org in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/neurodivergent-visual-org in your project. Codex loads it when a task matches its description.
Can I use Neurodivergent Visual Org in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill neurodivergent-visual-org -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/neurodivergent-visual-org, .gemini/skills/neurodivergent-visual-org, .github/skills/neurodivergent-visual-org and .opencode/skills/neurodivergent-visual-org in your project.
What does Neurodivergent Visual Org need to run?
SKILL.md names no scripts, command-line tools or credentials: Neurodivergent Visual Org is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Glob, Bash(cmd:*). Compatibility (from SKILL.md): Designed for Claude Code.
Does Neurodivergent Visual Org access the network?
SKILL.md names 2 domains. In commands or code: mermaid.live; the agent is likely to contact it when it follows the instructions. As links in the text: mermaid.js.org. This is read from the text; nothing was executed.
Is Neurodivergent Visual Org safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Neurodivergent Visual Org use?
Neurodivergent Visual Org is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Neurodivergent Visual Org use?
About 5k tokens (SKILL.md is roughly 20k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.
What are the alternatives to Neurodivergent Visual Org?
Skills that share tags, products or a category with Neurodivergent Visual Org: I Have Adhd (TanStack/ai, 3.2k stars), Attention Kind (alexgreensh/attention-span, 1.4k stars), Remind Me (shaheer-00/claude-adhd, 105 stars) and Daily Focus Board (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Neurodivergent Visual Org?
jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.
Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.