CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

drawio

Always use when user asks to create, generate, draw, or design a diagram, flowchart, architecture diagram, ER diagram, sequence diagram, class diagram, network diagram, mockup, wireframe, or UI sketch, or mentions draw.io, drawio, drawoi, .drawio files, or diagram export to PNG/SVG/PDF. Exception: in a chat that shows diagrams inline (VS Code's or Cursor's own chat, Claude.ai, ChatGPT) where the draw.io MCP server's create_diagram tool is available, call that tool instead, unless the user asks for a file or an export. Claude Code, Codex and Copilot CLI, also in their VS Code and JetBrains extensions, don't show diagrams inline: use this skill there.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An unusually actionable, well-sequenced body: every step is executable, validation (the repair pass) and error-recovery loops are explicit, and bulk reference material is properly deferred to fetch-on-demand URLs and a bundled script. The remaining room is trimming redundancy (repeated export-command variants) and moving the Windows CLI-discovery scripts out of the main file.

DimensionReasoningScore

Conciseness

The body is dense and operational — CLI flags, WSL2 registry scans, the .url-file workaround — with essentially no explanation of concepts Claude already knows. It falls short of lean level 5 because the export command recurs in near-duplicate variants across sections and the platform-specific CLI-location machinery (~90 lines of registry/PowerShell scripts) runs long inline. It is well above level 3, which would require unnecessary explanation or padding.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready commands like `drawio -x -f xml -o diagram.drawio diagram.mmd` and `drawio -x -f png -e -b 10 -o diagram.drawio.png diagram.drawio`, a working node URL one-liner, the repair-pass script, a complete PowerShell finder, and a troubleshooting table keyed to exact error strings ("GPU process isn't usable. Goodbye."). Matches the level-5 anchor with specific examples covering the common cases.

5 / 5

Workflow Clarity

"The pipeline" gives a numbered Author → Deliver → Open sequence, the repair pass is an explicit validation checkpoint ("Run this right after writing XML to a .drawio file, before any layout, export or URL step"), and error recovery is covered by the troubleshooting table and the open-failure fallback ("If the open command fails, print the absolute path (or URL)"). Explicit validation plus feedback loops matches level 5.

5 / 5

Progressive Disclosure

The bundled `scripts/find-shapes.js` exists and is referenced with its exact invocation, and the heavyweight Mermaid/XML material is correctly kept out as one-level, fetch-on-demand URLs with clear conditions ("Only when a diagram needs layers, tags, metadata and placeholders … also fetch the full XML reference"). It stops short of level 5 because ~90 lines of Windows CLI-location scripts are inlined in SKILL.md rather than split into a reference file, making the body a long single file.

4 / 5

Total

18

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, trigger-rich description with comprehensive natural keywords, an explicit "use when" clause, and well-scoped exception guidance for inline-viewer chats. Its only weaknesses are a thin statement of the underlying mechanism (native .drawio files, layouts, URL output) and slight generic-trigger overlap with other diagramming approaches.

DimensionReasoningScore

Specificity

Names several concrete actions and outputs — "create, generate, draw, or design a diagram, flowchart, architecture diagram, ER diagram, sequence diagram, class diagram, network diagram, mockup, wireframe, or UI sketch" and "diagram export to PNG/SVG/PDF" — but never states the mechanism (native .drawio authoring, ELK layouts, browser URL output), leaving minor gaps in coverage. It is above level 3 because multiple specific actions are listed, but short of level 5's comprehensive coverage.

4 / 5

Completeness

Explicitly answers both what ("create, generate, draw, or design a diagram", "diagram export to PNG/SVG/PDF") and when ("Always use when user asks to… or mentions draw.io, drawio, drawoi, .drawio files") with concrete trigger phrases, and adds explicit exception guidance ("call that tool instead, unless the user asks for a file or an export"). Level 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms and file extensions: "draw.io, drawio, drawoi, .drawio files" plus a full list of natural user phrasings ("flowchart", "architecture diagram", "mockup", "wireframe", "UI sketch") and export formats. This matches the level-5 anchor exactly; level 4 would require missing natural terms, and none are apparent.

5 / 5

Distinctiveness Conflict Risk

Distinctive draw.io-anchored triggers ("draw.io", "drawoi", ".drawio files") give it a clear niche, but generic terms like "diagram", "flowchart" and "mockup" carry minor overlap risk with other diagramming or wireframing skills. Mostly distinct with minor overlap — the level-4 anchor — rather than the minimal-conflict level 5.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jgraph/drawio-mcp

Path

plugins/claude-code/skills/drawio/SKILL.md

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.