CtrlK
BlogDocsLog inGet started
Tessl Logo

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'.

57

Quality

67%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/productivity/neurodivergent-visual-org/skills/neurodivergent-visual-org/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.