neurodivergent-visual-org
tessl i github:jeremylongshore/claude-code-plugins-plus-skills --skill neurodivergent-visual-orgCreates 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.
Review Score
63%
Validation Score
12/16
Implementation Score
27%
Activation Score
100%
Generated
Validation
Total
12/16Score
Passed| Criteria | Score |
|---|---|
skill_md_line_count | SKILL.md is long (727 lines); consider splitting into references/ and linking |
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) |
metadata_version | 'metadata' field is not a dictionary |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata |
Implementation
Suggestions 4
Score
27%Overall Assessment
This skill contains valuable domain knowledge about neurodivergent-friendly design but suffers from severe verbosity and poor organization. The extensive explanations of research, psychology, and WCAG compliance add token overhead without improving Claude's ability to execute. The Quick Reference Card at the end is the most actionable section but is buried after hundreds of lines of context.
Suggestions
- Move the Quick Reference Card to the top as the primary actionable content, with detailed explanations in separate reference files
- Extract the configuration schema, Mermaid syntax guide, and color palettes into separate .md files referenced from the main skill
- Remove explanatory content about why things work (color psychology research, Miller's Law explanations) - Claude knows these concepts
- Add a clear numbered workflow: 1. Detect mode → 2. Identify diagram type → 3. Generate with template → 4. Validate → 5. Provide playground link
| Dimension | Score | Reasoning |
|---|---|---|
Conciseness | 1/3 | Extremely verbose at 500+ lines with extensive explanations of concepts Claude already knows (color psychology research, Miller's Law, WCAG compliance details). The mode detection algorithm is written as pseudocode that could be condensed to a simple table. Much content explains 'why' rather than 'what to do'. |
Actionability | 2/3 | Contains concrete Mermaid code examples that are executable, but much guidance is abstract (e.g., 'use compassionate language', 'be realistic'). The diagram selection tables are helpful but the actual implementation details are buried in verbose explanations. Missing complete end-to-end examples for common scenarios. |
Workflow Clarity | 2/3 | The mode detection algorithm provides a clear sequence, but the overall workflow for creating a diagram is implicit rather than explicit. No clear step-by-step process like '1. Detect mode, 2. Select diagram type, 3. Apply styling, 4. Validate output'. The Quick Reference Card at the end helps but comes too late. |
Progressive Disclosure | 1/3 | Monolithic wall of text with no references to external files. All content is inline including detailed configuration schemas, complete syntax guides, and extensive tables. Content that should be in separate reference files (full Mermaid syntax, configuration schema, color palettes) is embedded in the main skill file. |
Activation
Score
100%Overall Assessment
This is a strong skill description that clearly articulates specific capabilities (Mermaid diagrams, task breakdowns, time estimates), includes natural trigger terms users would actually say, and has an explicit 'Use when...' clause. The neurodivergent/accessibility focus creates a distinct niche that minimizes conflict with other organizational or diagramming skills.
| Dimension | Score | Reasoning |
|---|---|---|
Specificity | 3/3 | Lists multiple concrete actions: 'Creates ADHD-friendly visual organizational tools', 'Mermaid diagrams', 'Auto-detects overwhelm', 'provides compassionate task breakdowns with realistic time estimates'. These are specific, actionable capabilities. |
Completeness | 3/3 | Clearly answers both what (creates ADHD-friendly visual tools, Mermaid diagrams, 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). |
Trigger Term Quality | 3/3 | Includes natural keywords users would say: 'visual task breakdowns', 'decision trees', 'organizational diagrams', 'neurodivergent', 'ADHD-friendly', 'accessibility-focused'. Good coverage of terms someone seeking this help would use. |
Distinctiveness Conflict Risk | 3/3 | Clear niche combining Mermaid diagrams + ADHD/neurodivergent focus + accessibility. Unlikely to conflict with generic diagramming or task management skills due to the specific neurodivergent/accessibility angle. |
- Last updated
- Created
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.