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

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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.

The content is highly actionable and mostly token-efficient, with clear sectioning and real, well-signaled reference files. Its main weakness is the workflow's lack of validation checkpoints around XML generation and the destructive post-export deletion step.

Suggestions

Add an explicit validation step to the workflow: after generating the .drawio XML, verify it opens/renders (e.g., via the CLI export or a quick parse) before proceeding to export.

Guard the destructive deletion step — only delete the .drawio source after confirming the export succeeded and the output file is valid, rather than unconditionally.

Reduce overlap between the inlined element styles / HTML template and references/xml-and-export.md so SKILL.md reads more as an overview pointing to the detailed reference.

Dimension	Reasoning	Score
Conciseness	The body is dense with actionable reference material (style strings, export commands, HTML template) and avoids explaining concepts Claude already knows, but the repeated full style strings and macOS/Linux export variants could be trimmed slightly.	4 / 5
Actionability	It provides exact XML structure, copy-paste style strings, concrete export commands with flags, and a complete HTML template with explicit escaping steps — fully executable and copy-paste ready.	5 / 5
Workflow Clarity	The five-step workflow is sequenced but has no validation checkpoints, and the export section advises a destructive action ("the .drawio source can be deleted") without a verify step, triggering the feedback-loop cap at 3.	3 / 5
Progressive Disclosure	Sections are well-organized and the two real bundle files (demo.drawio, xml-and-export.md) are clearly signaled one level deep, but substantial reference content inlined in the body overlaps with the referenced file, leaving minor organization gaps.	4 / 5
	Total	16 / 20 Passed

Description

100%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.

The description is concise, specific, and clearly distinguishes the skill's niche with explicit trigger guidance. It answers both what and when without verbosity or over-claims.

Dimension	Reasoning	Score
Specificity	"Generate .drawio architecture diagrams with consistent visual style and export to PNG/SVG/PDF/HTML" lists multiple concrete actions (generate, export to four formats) with comprehensive coverage, matching the score-5 anchor.	5 / 5
Completeness	It explicitly states what it does and follows with a "Use when..." clause listing concrete trigger phrases, satisfying both what and when per the score-5 anchor.	5 / 5
Trigger Term Quality	Natural phrases users would say ("create a diagram", "draw architecture", "make a drawio file", "build a diagram") plus the "drawio" term give comprehensive synonym coverage, matching the score-5 anchor.	5 / 5
Distinctiveness Conflict Risk	"drawio architecture diagrams" is a clear niche with distinct, specific triggers (drawio, architecture diagram, system diagram) and minimal overlap risk with other skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: 4316684

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.