CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

drawio-logical-diagrams

Creates professional logical flow diagrams and logical system architecture diagrams using draw.io XML format (.drawio files). Use when creating: (1) logical flow diagrams showing data/process flow between system components, (2) logical architecture diagrams representing system structure without cloud provider specifics, (3) BPMN process diagrams, (4) UML diagrams (class, sequence, activity), (5) data flow diagrams (DFD), (6) decision flowcharts, or (7) system interaction diagrams. This skill focuses on generic/abstract representations, not AWS/Azure-specific architectures (use aws-drawio-architecture-diagrams for cloud diagrams).

68

Quality

85%

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

The canonical home for this skill is giuseppe-trisciuoglio/developer-kit

SKILL.md
Quality
Evals
Security

Quality

Content

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

Highly actionable content with concrete, copy-paste-ready draw.io XML and complete worked examples, but it is held back by inline duplication of bundle material (color palette, constraints) and by a bundle where 5 of 7 reference files are never linked. The workflow has a validation checklist but lacks an error-recovery feedback loop, which the rubric caps at 3 for XML-manipulation skills.

Suggestions

Link the five orphaned reference files (color-palette.md, constraints-warnings.md, diagram-types-detailed.md, layout-best-practices.md, shape-examples.md) from the Reference Files section so the bundle is navigable.

Replace the inline Standard Color Palette table and Constraints and Warnings section with pointers to references/color-palette.md and references/constraints-warnings.md to remove the duplication and tighten the token budget.

Add a validation feedback loop after the XML Validation Checklist — e.g. 'If validation fails, fix the flagged cells and re-run the checklist before writing the file' — to lift workflow_clarity above the rubric's cap of 3.

DimensionReasoningScore

Conciseness

Mostly efficient — tables and style strings carry real information — but the body inlines content duplicated in the bundle: the 9-row "Standard Color Palette" table (identical to references/color-palette.md) and the "Constraints and Warnings" section (expanded in references/constraints-warnings.md), plus two ~25-line full XML examples that overlap diagram-templates.md. That is more than the 'minor trim' of anchor 4, fitting anchor 3's 'could be tightened'.

3 / 5

Actionability

Everything is executable and copy-paste ready: the complete mxfile/mxGraphModel skeleton, exact style strings per shape type (e.g. `shape=cylinder3;whiteSpace=wrap;html=1;boundedLbl=1;`), full connector style strings, and two complete, valid XML examples with consistent IDs, coordinates, and colors. Not 4 because there are no gaps — the common flowchart and architecture cases are fully covered end-to-end.

5 / 5

Workflow Clarity

The 8-step "Creating a Logical Diagram" sequence is clear and an explicit XML Validation Checklist exists before output, but there is no feedback loop — nothing says what to do when validation fails (fix and re-validate). The rubric's scoring note caps workflow_clarity at 3 for XML manipulation skills missing validate→fix→retry loops, so this cannot score 4 despite the explicit checklist.

3 / 5

Progressive Disclosure

The bundle has 7 reference files but the body links only 2 (shape-styles.md, diagram-templates.md); color-palette.md, constraints-warnings.md, diagram-types-detailed.md, layout-best-practices.md, and shape-examples.md are orphaned and undiscoverable, and the palette/constraints content that should live in those files is inlined instead. This matches anchor 3 ('content that should be separate is inline') rather than anchor 4, where organization gaps would be minor.

3 / 5

Total

14

/

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.

A strong description in third-person voice with a concrete 'what', an enumerated 'Use when' trigger list covering seven diagram types, the file extension, and an explicit disambiguation against the sibling AWS/Azure skill. It closely matches the rubric's good overall examples.

DimensionReasoningScore

Specificity

The description states concrete actions with a named output format — "Creates professional logical flow diagrams and logical system architecture diagrams using draw.io XML format (.drawio files)" — and the trigger list enumerates seven specific diagram types (BPMN, UML class/sequence/activity, DFD, decision flowcharts, system interaction diagrams), giving comprehensive coverage of the skill's domain. Not 4 because coverage is comprehensive rather than having minor gaps; the mild buzzword "professional" is the only padding.

5 / 5

Completeness

It explicitly answers both questions: "what" ("Creates ... diagrams using draw.io XML format (.drawio files)") and "when" ("Use when creating: (1) ... (7) ..." with concrete trigger phrases). Both are explicit and concrete, matching the anchor-5 example structure; not 4 since the 'when' clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Natural user phrases are comprehensively covered: "flow diagram", "architecture diagram", "BPMN", "UML", "sequence", "data flow diagram (DFD)", "flowchart", ".drawio files", and "AWS/Azure" for the negative boundary. This matches the anchor-5 pattern (synonyms plus file extension) rather than the anchor-4 "a few natural terms missing" case.

5 / 5

Distinctiveness Conflict Risk

It carves a clear niche — "generic/abstract representations, not AWS/Azure-specific architectures (use aws-drawio-architecture-diagrams for cloud diagrams)" — explicitly disambiguating against the sibling cloud-architecture skill. Minimal conflict risk; not 4 because the boundary is stated rather than merely implied.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

giuseppe-trisciuoglio/developer-kit

Path

plugins/developer-kit-core/skills/drawio-logical-diagrams/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.