CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

drawio-diagram

Generate .drawio architecture diagrams with consistent visual style and export to PNG/SVG/PDF/HTML. Use when user asks to "create a diagram", "draw architecture", "make a drawio file", "build a diagram", or mentions "drawio", "architecture diagram", or "system diagram".

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

76%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 highly actionable, well-organized skill body whose style conventions and export procedures are copy-paste ready. Its main gaps are the absence of any validation checkpoints in the workflow (notably deleting the .drawio source after an unverified export) and verbatim duplication of several sections with references/xml-and-export.md, which wastes tokens and blurs the overview/reference split.

Suggestions

Add a validation step to the workflow between generation and export (e.g., open the .drawio in draw.io or validate the XML structure), and only recommend deleting the .drawio source after confirming the export succeeded.

De-duplicate the body against references/xml-and-export.md: keep only the essential skeleton and one export command inline, and move the full flag list, file naming, and HTML label details to the reference file.

Trim the HTML Labels section's explanations of basic tags like <b> and <br> down to just the standard label pattern the skill mandates.

DimensionReasoningScore

Conciseness

The body is dense with genuinely non-obvious material — exact style strings, CLI flags, sizing conventions — and assumes Claude's competence about diagramming concepts rather than padding. However, there are minor trimmable instances: the HTML Labels section explains basics like '<b>Title</b>' and '<br>' that Claude already knows, and the XML skeleton, CLI export commands, and file-naming sections are duplicated nearly verbatim in references/xml-and-export.md, inflating the body. This matches anchor 4 ('efficient; minor instances of over-explanation that could be trimmed') better than anchor 3, since the bulk of every section is skill-specific and load-bearing.

4 / 5

Actionability

The guidance is fully executable: a complete mxfile XML skeleton, exact copy-paste style strings for every element type, per-OS CLI export commands with flag explanations, a complete self-contained HTML template with a 4-step escape-and-embed procedure, and concrete dimensions (25x25 protocol circles, 80x20 legend pills, 90px spacing). This matches anchor 5's 'fully executable, copy-paste ready, covers common cases'.

5 / 5

Workflow Clarity

The 5-step workflow (understand → plan → generate → add legend → export) gives a clear sequence, but there are no validation checkpoints anywhere: no step to verify the generated XML renders correctly in draw.io, and no check that the export succeeded before advising 'After export, the .drawio source can be deleted' — deleting the source on an unverified export is a real failure mode. This matches anchor 3 ('steps listed but validation gaps; sequence present but checkpoints missing or implicit'); anchor 4 requires most checkpoints present, and none are.

3 / 5

Progressive Disclosure

References are real, one level deep, and clearly signaled with per-file descriptions ('demo.drawio — example output with all element types', 'xml-and-export.md — detailed XML structure and CLI reference'), and the body is well-sectioned. However, the split is not clean: the XML structure, HTML labels, CLI export, and file-naming sections are duplicated between the body and xml-and-export.md, so content is carried twice rather than appropriately delegated. This fits anchor 4 ('good structure; references mostly clear; minor organization gaps') rather than anchor 5's cleanly split overview, and is well above anchor 3's buried or unorganized references.

4 / 5

Total

16

/

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 description that clearly states a concrete capability set and pairs it with an explicit, well-populated 'Use when' trigger clause including synonyms and the file extension. The only weaknesses are minor: broad generic phrases like 'create a diagram' carry slight overlap risk with other diagramming tools, and the capability list could enumerate one or two more differentiating features.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Generate .drawio architecture diagrams with consistent visual style and export to PNG/SVG/PDF/HTML' — naming the domain, the deliverable, style consistency, and four export formats. It falls short of anchor 5's comprehensive multi-action coverage (no mention of legends, element taxonomies, or HTML export detail), but exceeds anchor 3's '1-2 concrete actions, not comprehensive' because the export format enumeration and style convention add real coverage.

4 / 5

Completeness

Both questions are explicitly answered: what ('Generate .drawio architecture diagrams with consistent visual style and export to PNG/SVG/PDF/HTML') and when ('Use when user asks to "create a diagram", "draw architecture"... or mentions "drawio", "architecture diagram", or "system diagram"'). This mirrors anchor 5's example structure of a concrete what followed by an explicit trigger clause with concrete phrases; it is clearly above anchor 4, where the when-clause is present but less specific.

5 / 5

Trigger Term Quality

Triggers include natural verb phrases users would actually say — 'create a diagram', 'draw architecture', 'make a drawio file', 'build a diagram' — plus keywords 'drawio', 'architecture diagram', 'system diagram', and the '.drawio' extension appears in the capability statement. This matches anchor 5's standard of synonyms (create/draw/make/build) plus file extension, exceeding anchor 4 which only requires good coverage with a few natural terms missing.

5 / 5

Distinctiveness Conflict Risk

The drawio/.drawio niche is clear and most triggers ('drawio', 'make a drawio file') are unambiguous, but generic phrases like 'create a diagram' or 'build a diagram' could overlap with other diagramming skills (mermaid, excalidraw, native canvas). This matches anchor 4 ('mostly distinct; minor overlap risk with closely related skills') rather than anchor 5, which requires minimal conflict risk across all triggers.

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

dwmkerr/claude-toolkit

Path

plugins/dwmkerr/skills/drawio-diagram/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.