CtrlK
BlogDocsLog inGet started
Tessl Logo

drawio

**WORKFLOW SKILL** — Generate Azure architecture diagrams in .drawio via simonkurtz-MSFT MCP server (full Azure icon set, batch creation, transactional mode). Covers architecture, dependency, runtime-flow, and as-built diagrams. WHEN: 'draw.io diagram', 'Azure architecture diagram', 'as-built diagram', 'runtime flow diagram', 'dependency diagram'. DO NOT USE FOR: WAF/cost charts (python-diagrams), inline Mermaid (mermaid).

75

Quality

92%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

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.

This is an excellent skill description that hits all the marks. It provides specific capabilities, natural trigger terms, explicit when/when-not guidance, and clear disambiguation from related skills. The 'DO NOT USE FOR' clause is a particularly strong addition that reduces conflict risk in a multi-skill environment.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: generate .drawio files, batch creation, transactional mode, and names four distinct diagram types (architecture, dependency, runtime-flow, as-built). Also specifies the tool (simonkurtz-MSFT MCP server) and asset (full Azure icon set).

3 / 3

Completeness

Clearly answers both 'what' (generate Azure architecture diagrams in .drawio format with specific capabilities) and 'when' (explicit WHEN clause with trigger phrases). Also includes a 'DO NOT USE FOR' clause that further clarifies scope boundaries.

3 / 3

Trigger Term Quality

Includes highly natural trigger terms users would say: 'draw.io diagram', 'Azure architecture diagram', 'as-built diagram', 'runtime flow diagram', 'dependency diagram'. These are specific phrases a user would naturally use when requesting these artifacts.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche (Azure .drawio diagrams via a specific MCP server). The 'DO NOT USE FOR' clause explicitly disambiguates from competing skills (python-diagrams for WAF/cost charts, mermaid for inline diagrams), minimizing conflict risk.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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

This is a strong, well-structured workflow skill that provides highly actionable guidance for Azure diagram generation via MCP tools. Its main weakness is redundancy — several critical rules (batch-only, text:"", shape_name constraints) are repeated 3+ times across sections, inflating token cost. The progressive disclosure and workflow clarity are excellent, with clear sequencing, validation checkpoints, and a comprehensive reference index.

Suggestions

Consolidate repeated rules (batch-only workflow, text:"" warning, shape_name constraints) into a single authoritative section and reference it from other sections rather than restating the same content verbatim in Rules, Steps, and Gotchas.

Remove the project-specific 'nordic-foods lessons plan' reference from the import-diagram warning — it adds no actionable value for the general skill and wastes tokens.

DimensionReasoningScore

Conciseness

The skill contains significant repetition — the batch-only workflow rule is stated in Rules, Steps, and Gotchas; the `text: ""` warning appears in Icon Handling, Rules, and Gotchas; `shape_name` constraints appear three times. The naming disambiguation note and some contextual explanations (e.g., the nordic-foods lessons plan reference) add tokens without clear value. However, the content is mostly domain-specific knowledge Claude wouldn't have, so it's not padding with basics.

2 / 3

Actionability

The skill provides concrete tool names, exact parameter conventions (e.g., `shape_name`, `temp_id`, `compress: true`), a specific 6-step call sequence, explicit wrong/right examples for `import-diagram`, and precise layout values (120px spacing, 850×1100px page size). The guidance is copy-paste ready and leaves no ambiguity about what to do.

3 / 3

Workflow Clarity

The workflow is clearly sequenced (search → create-groups → add-cells → assign → validate → finish), includes an explicit validation checkpoint (`validate-group-containment`), a critical post-processing step (save-drawio.py), and error-prevention guidance (transactional mode must end with finish-diagram). The feedback loop for containment validation and the import-diagram wrong/right pattern demonstrate strong error recovery awareness.

3 / 3

Progressive Disclosure

The skill provides a concise overview with well-signaled one-level-deep references to 11 reference files and 5 example files, each with a clear purpose description. Detailed content (style properties, creation workflows, azure patterns, validation checklists) is appropriately delegated to reference files while the main skill retains a usable summary.

3 / 3

Total

11

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jonathan-vella/azure-agentic-infraops
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.