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'.
57
67%
Does it follow best practices?
Impact
—
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, provides concrete actions, and includes explicit trigger guidance. The combination of Mermaid diagrams, neurodivergent focus, and accessibility creates a distinctive identity. Minor weakness: some trigger terms like 'visual' and 'org' are generic enough to potentially cause false matches, but the overall context mitigates this.
| 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, plus trigger terms). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'ADHD', 'neurodivergent', 'visual', 'Mermaid diagrams', 'task breakdowns', 'decision trees', 'organizational diagrams', 'accessibility'. The explicit trigger terms 'neurodivergent', 'visual', 'org' are also provided, though 'org' is quite generic and 'visual' could overlap with other skills. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a very clear niche combining Mermaid diagrams + neurodivergent/ADHD focus + accessibility. The combination of these domains makes it highly unlikely to conflict with generic diagramming or generic task management skills. The trigger terms 'neurodivergent' and 'ADHD' are highly distinctive, though 'visual' and 'org' alone could overlap. | 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 is comprehensive in scope but severely undermined by verbosity and poor structural organization. It explains research rationale and cognitive science concepts that Claude doesn't need, buries the actionable instructions at the bottom, and includes extensive inline reference material that should be in separate files. The progressive disclosure references are well-structured but the main file itself violates the principle by front-loading hundreds of lines of detail before the core workflow.
Suggestions
Move the Mode System details, Color Psychology section, Design Standards, and Diagram Selection Guide into reference files, keeping only a brief summary and links in SKILL.md
Restructure to put the Instructions/Overview/Quick Reference at the top, with detailed reference material linked below — the current layout buries actionable content under extensive background
Remove explanatory sections like 'Why Visual Tools Work for ADHD Brains' — Claude doesn't need research justification, just the design rules to follow
Add a validation checkpoint in the workflow: after generating the diagram, verify Mermaid syntax is valid and playground link renders correctly before presenting to user
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at hundreds of lines. Explains concepts Claude already knows (why visual tools work for ADHD, Miller's Law, color psychology research, working memory theory). The 'Why Visual Tools Work for ADHD Brains' section, extensive color psychology guidance, and multiple large selection tables are unnecessary padding. Much of this content could be condensed to a fraction of its size. | 1 / 3 |
Actionability | Provides concrete diagram type selection tables and URL encoding examples with executable Python code, but the actual diagram generation guidance is mostly descriptive rather than executable. The skill references truncated syntax guides ('[Content continues...]') and lacks complete copy-paste-ready Mermaid diagram examples showing full output for each scenario. | 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 helpful. However, there are no validation checkpoints — no step to verify the generated Mermaid renders correctly before presenting to the user, and no feedback loop for fixing broken diagrams. The 'Testing Links' section mentions verification but isn't integrated into the workflow. | 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 main SKILL.md contains massive amounts of inline content (mode system details, color psychology, full diagram selection guides, design standards) that should be in reference files. The overview and instructions are buried at the bottom after hundreds of lines of detail, inverting the expected structure. | 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 | |
4801da6
Table of Contents
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.