**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
92%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
a0098f9
Table of Contents
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.