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. Use when creating visual task breakdowns, decision trees, or organizational diagrams for neurodivergent users or accessibility-focused projects. Trigger with 'neurodivergent', 'visual', 'org'.
72
67%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/productivity/neurodivergent-visual-org/skills/neurodivergent-visual-org/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description that clearly communicates a specific niche capability. It lists concrete actions, provides explicit trigger guidance with a 'Use when...' clause, and occupies a distinctive space that would be hard to confuse with other skills. Minor concern is that some trigger terms like 'visual' and 'org' are overly broad and could cause false positives, but the overall context narrows them sufficiently.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creates visual organizational tools using Mermaid diagrams, auto-detects overwhelm, provides compassionate task breakdowns with realistic time estimates. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (creates ADHD-friendly visual tools using Mermaid, auto-detects overwhelm, provides task breakdowns with time estimates) and 'when' (explicit 'Use when...' clause specifying visual task breakdowns, decision trees, organizational diagrams for neurodivergent users or accessibility projects). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'ADHD-friendly', 'neurodivergent', 'visual', 'Mermaid diagrams', 'task breakdowns', 'decision trees', 'organizational diagrams', 'accessibility'. The explicit trigger terms 'neurodivergent', 'visual', 'org' are also provided, though 'visual' and 'org' are quite broad. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a very clear niche combining Mermaid diagrams + neurodivergent/ADHD focus + accessibility. Unlikely to conflict with generic diagramming or task management skills due to the specific neurodivergent and compassionate framing. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill has a solid conceptual foundation and good reference file structure, but suffers from severe verbosity — explaining ADHD neuroscience, color psychology, and Miller's Law that Claude already knows. The content is poorly organized with the actual instructions buried at the bottom after extensive inline reference material that should be in separate files. The actionable core (mode detection → diagram selection → generation → output) is sound but obscured by excessive context.
Suggestions
Move the massive inline tables (diagram selection guide, color psychology, design standards, mode characteristics) into reference files and keep only a quick-reference summary in SKILL.md — this could cut the file by 60-70%.
Remove explanatory sections like 'Why Visual Tools Work for ADHD Brains' and research citations — Claude doesn't need to be taught why the approach works, just how to execute it.
Restructure so Instructions/Quick Reference appear at the top, not buried after 300+ lines of background material.
Add a validation step in the workflow: after generating the Mermaid diagram, verify syntax is valid (e.g., check for common errors like unescaped characters) before presenting to the user.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose. Explains concepts Claude already knows (why visual tools work for ADHD, Miller's Law, color psychology research, working memory). The 'Why Visual Tools Work for ADHD Brains' section, extensive color psychology guidance, and massive diagram selection tables add significant token cost. Much of this is general knowledge Claude possesses. The skill could be reduced to ~30% of its current size without losing actionable content. | 1 / 3 |
Actionability | Provides concrete guidance on diagram type selection and URL encoding with executable Python code, but the actual Mermaid diagram examples are incomplete (noted as '[Content continues... truncating here]'). The instructions section is clear but brief compared to the massive preamble. Many sections describe principles rather than providing copy-paste ready diagram templates. | 2 / 3 |
Workflow Clarity | The Instructions section provides a clear 4-step sequence (detect mode → choose diagram → apply standards → generate output), and the error handling table is useful. However, there's no validation checkpoint — no step to verify the generated Mermaid diagram renders correctly before presenting to the user, and no feedback loop for fixing rendering issues. The mode detection workflow is deferred to a reference file without a summary. | 2 / 3 |
Progressive Disclosure | References to external files (mode-detection-algorithm.md, accessibility-modes.md, configuration-schema.md) are well-signaled and one level deep, which is good. However, the SKILL.md itself is a monolithic wall of text with massive inline tables and sections (mode characteristics, color psychology, diagram selection guide, design standards) that should be in reference files. The overview and instructions are buried at the bottom after hundreds of lines of inline detail. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
3a2d27d
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.