CtrlK
BlogDocsLog inGet started
Tessl Logo

drawio

Generate draw.io diagrams programmatically using Python. Creates flowcharts, architecture diagrams, tree structures, network diagrams, and more. Use when the user requests a .drawio file, diagram, flowchart, or visual documentation.

93

3.17x
Quality

Does it follow best practices?

Impact

89%

3.17x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

87%

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

The body is well-structured, executable, and cleanly offloads detail to real reference and script files. The one gap is a missing verification checkpoint for batch .drawio generation, which caps workflow clarity at 2.

Suggestions

Add an explicit verification step after generation — e.g., 'After writing the .drawio file, open/preview it (or re-read the XML) to confirm it renders without errors before presenting to the user' — to satisfy the batch-operation feedback-loop expectation.

Move the inline 'Common Shape Libraries' enumeration into references/REFERENCE.md and keep only a pointer here, reducing redundancy with the reference material.

Clarify how to choose between the helper scripts and custom code in the Decision Tree (e.g., note when create_tree.py's auto-layout is preferable to hand-positioned Object/Edge code).

DimensionReasoningScore

Conciseness

The body is lean — quick start, a routing decision tree, compact code, and a script table — and never explains concepts Claude already knows (e.g., what draw.io is); every section is functional, matching the 'lean and efficient; assumes competence' anchor. Not score 2 because there is no unnecessary explanation, though the inline shape-library list and a slight overlap between Key Concepts code and helper scripts keep it from being exemplary.

3 / 3

Actionability

Provides fully executable, copy-paste-ready guidance throughout — 'uv run scripts/create_flowchart.py steps.json /mnt/user-data/outputs/flow.drawio', complete drawpyo Object/Edge/styling snippets, and a script table with exact usage — matching the 'fully executable code/commands' anchor; not score 2 because code is complete, not pseudocode.

3 / 3

Workflow Clarity

The Decision Tree provides a clear sequenced routing by diagram type and the Output section gives a concrete final step, but there is no validation/verification checkpoint (e.g., confirming the generated .drawio opens/renders) for this batch file-generation operation, matching the 'steps listed but validation gaps' anchor. Not score 3 because the feedback-loop guideline for batch operations calls for an explicit verify step; not score 1 because the sequence and output handling are clearly present.

2 / 3

Progressive Disclosure

SKILL.md is a clear overview with well-signaled, one-level-deep references ('references/REFERENCE.md: Complete API documentation', 'references/examples.md', 'scripts/'), all of which resolve to real files, and content is appropriately split — matching the 'clear overview with well-signaled one-level-deep references' anchor. Not score 2 because references are explicitly signaled, not buried.

3 / 3

Total

11

/

12

Passed

Description

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.

The description is strong across all dimensions: third-person voice, concrete actions, natural trigger terms, an explicit 'Use when' clause, and a distinct niche. No changes needed.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Generate draw.io diagrams programmatically using Python', 'Creates flowcharts, architecture diagrams, tree structures, network diagrams' — matching the 'lists multiple specific concrete actions' anchor; not score 2 because it goes well beyond naming a domain plus a few actions.

3 / 3

Completeness

Explicitly answers both what ('Generate... Creates flowcharts, architecture diagrams...') and when ('Use when the user requests a .drawio file, diagram, flowchart, or visual documentation'), matching the 'clearly answers both what AND when with explicit triggers' anchor; not score 2 because the 'when' is explicit, not merely implied.

3 / 3

Trigger Term Quality

Covers natural user vocabulary — '.drawio file', 'diagram', 'flowchart', 'visual documentation' — terms a user would actually say; not score 2 because common variations are present rather than missing.

3 / 3

Distinctiveness Conflict Risk

Targets a distinct, specific niche (draw.io / .drawio file generation) with dedicated triggers, making it unlikely to fire for an unrelated skill; not score 2 because the niche and triggers are clearly demarcated.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
fpl9000/ai-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.