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

The canonical home for this skill is drawio in jgraph/drawio-mcp

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.

A high-quality, highly executable skill body: every step is a concrete command, the pipeline is clearly sequenced with an explicit repair/validation pass and a thorough troubleshooting table, and heavy syntax references are properly pushed out to on-demand fetches. The only weaknesses are minor: a few trimmable explanatory clauses and some platform-specific discovery chains that would sit better as bundled scripts.

DimensionReasoningScore

Conciseness

The body is dense and operational — pipeline, flag tables, and platform-specific fallback chains with almost no concept explanation Claude already knows. A few tokens could be trimmed (e.g., explaining that backticks in bash are command substitution, and the 'Inline viewer first' section restating the description's MCP exception), placing it just below 'every token earns its place'.

4 / 5

Actionability

Fully executable throughout: exact CLI invocations with all flags (`drawio -x -f xml -o diagram.drawio diagram.mmd`), complete copy-paste Node/PowerShell/bash one-liners for URL generation and CLI discovery, an XML skeleton, and a working repair-pass script. Concrete examples cover the common cases (Mermaid vs XML, each output format, each platform).

5 / 5

Workflow Clarity

A numbered 3-step pipeline (Author → Deliver → Open) with an explicit repair pass ordered 'right after writing XML... before any layout, export or URL step', a failure fallback ('If the open command fails, print the absolute path'), and a troubleshooting table giving cause→solution feedback loops (e.g., retry with --disable-gpu, two-step Mermaid conversion). Validation and error recovery are explicit, matching the top anchor.

5 / 5

Progressive Disclosure

Good structure: SKILL.md stays an operational overview, delegating Mermaid syntax and XML detail to clearly signaled, conditionally fetched references ('Only when a diagram needs layers, tags, metadata...'), and shipping a real one-level-deep script (scripts/find-shapes.js, verified to exist and match its description). Minor gaps keep it below 5: the inline find-drawio.ps1 PowerShell script and the WSL2/Windows registry-scan chains are bundle-file material kept in the main body, and the syntax references are remote URLs rather than bundled files.

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.

An excellent description: exhaustive, natural trigger coverage (including typo and extension variants), explicit what-and-when framing, and sophisticated boundary handling against the MCP tool. The only improvements are naming the .drawio/URL outputs in the what-clause and weighing whether mockup/wireframe/UI-sketch triggers are worth the slight overlap with UI-generation skills.

DimensionReasoningScore

Specificity

Names concrete actions — 'create, generate, draw, or design a diagram' and 'diagram export to PNG/SVG/PDF' — with extensive artifact-type enumeration. Not 5 because the capability set has minor gaps (the .drawio file output and browser-URL mode the body delivers are never stated); not 3 because several distinct concrete actions are listed.

4 / 5

Completeness

Explicitly answers both: what — creating/designing diagrams and exporting to PNG/SVG/PDF; when — 'Always use when user asks to create, generate, draw, or design a diagram... or mentions draw.io... or .drawio files', with concrete trigger phrases and even an explicit exception clause for inline-capable chats. The 'when' cannot be more explicit, so the anchor-4 fit is ruled out.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms (draw.io/drawio plus the common 'drawoi' typo), file extension (.drawio files), every major diagram type (flowchart, ER, sequence, class, network...), and export formats (PNG/SVG/PDF). No common variation a user would say is missing, matching the top anchor.

5 / 5

Distinctiveness Conflict Risk

A clear diagram/draw.io niche with distinct triggers, and it actively manages the one real conflict (deferring to the MCP create_diagram tool in inline chats). Not 5 because 'mockup, wireframe, or UI sketch' carries minor overlap with UI-generation/frontend skills; not 3 because the core triggers are unambiguous and the conflict handling is explicit.

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/antigravity/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.