Azv Diagram Azure Sync
Azure/AZVerify
Compare a Draw.io Azure architecture diagram against a live Azure environment to detect drift.
Creates and edits architecture diagrams through the Draw.io MCP tool, with guidance for rendering Azure icons correctly and laying out network diagrams.
Install Azure Draw.io MCP Diagrams
$ npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install thomast1906/github-copilot-agent-skills azure-drawio-mcp-diagramming --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/thomast1906/github-copilot-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/azure-drawio-mcp-diagramming .claude/skills/azure-drawio-mcp-diagramming && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "azure-drawio-mcp-diagramming" agent skill from https://github.com/thomast1906/github-copilot-agent-skills/tree/main/.github/skills/azure-drawio-mcp-diagramming into .claude/skills/azure-drawio-mcp-diagramming/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "azure-drawio-mcp-diagramming", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/thomast1906/github-copilot-agent-skills/tree/main/.github/skills/azure-drawio-mcp-diagrammingType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install thomast1906/github-copilot-agent-skills azure-drawio-mcp-diagramming --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thomast1906/github-copilot-agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/azure-drawio-mcp-diagramming .agents/skills/azure-drawio-mcp-diagramming && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "azure-drawio-mcp-diagramming" agent skill from https://github.com/thomast1906/github-copilot-agent-skills/tree/main/.github/skills/azure-drawio-mcp-diagramming into .agents/skills/azure-drawio-mcp-diagramming/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "azure-drawio-mcp-diagramming", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install thomast1906/github-copilot-agent-skills azure-drawio-mcp-diagramming --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thomast1906/github-copilot-agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/azure-drawio-mcp-diagramming .cursor/skills/azure-drawio-mcp-diagramming && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "azure-drawio-mcp-diagramming" agent skill from https://github.com/thomast1906/github-copilot-agent-skills/tree/main/.github/skills/azure-drawio-mcp-diagramming into .cursor/skills/azure-drawio-mcp-diagramming/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "azure-drawio-mcp-diagramming", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/thomast1906/github-copilot-agent-skills.git --path .github/skills/azure-drawio-mcp-diagramming--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install thomast1906/github-copilot-agent-skills azure-drawio-mcp-diagramming --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thomast1906/github-copilot-agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/azure-drawio-mcp-diagramming .gemini/skills/azure-drawio-mcp-diagramming && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "azure-drawio-mcp-diagramming" agent skill from https://github.com/thomast1906/github-copilot-agent-skills/tree/main/.github/skills/azure-drawio-mcp-diagramming into .gemini/skills/azure-drawio-mcp-diagramming/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "azure-drawio-mcp-diagramming", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install thomast1906/github-copilot-agent-skills azure-drawio-mcp-diagrammingInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/thomast1906/github-copilot-agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/azure-drawio-mcp-diagramming .github/skills/azure-drawio-mcp-diagramming && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "azure-drawio-mcp-diagramming" agent skill from https://github.com/thomast1906/github-copilot-agent-skills/tree/main/.github/skills/azure-drawio-mcp-diagramming into .github/skills/azure-drawio-mcp-diagramming/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "azure-drawio-mcp-diagramming", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install thomast1906/github-copilot-agent-skills azure-drawio-mcp-diagramming --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/thomast1906/github-copilot-agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/azure-drawio-mcp-diagramming .opencode/skills/azure-drawio-mcp-diagramming && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "azure-drawio-mcp-diagramming" agent skill from https://github.com/thomast1906/github-copilot-agent-skills/tree/main/.github/skills/azure-drawio-mcp-diagramming into .opencode/skills/azure-drawio-mcp-diagramming/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "azure-drawio-mcp-diagramming", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
azure-drawio-mcp-diagramming- GitHub stars
- 202
- Token cost
- ~3.1k tokens
- SKILL.md length
- 1,112 words
- Files
- 5 (incl. scripts, references)
- Skills in repo
- 15
- Repo updated
- First seen
- Licence
- None found
At a glance
Creates and edits architecture diagrams through the Draw.io MCP tool, with guidance for rendering Azure icons correctly and laying out network diagrams.
- Works in 8 steps: If diagram uses Azure icons: grep… → If diagram is not Azure-specific: skip… → For Azure infrastructure/network… → …
- Drawing an Azure architecture or network topology diagram
- SKILL.md covers When to Use, Required Tooling, Recommended Workflow and Visual Quality Guardrails, plus 9 more sections
- Runs Python scripts from its folder; calls python3; reaches mcp.draw.io and raw.githubusercontent.com
What it does
The skill uses the `drawio/create_diagram` MCP tool, which needs a `drawio` server in the workspace MCP config. For Azure diagrams the agent searches `references/azure2-complete-catalog.txt` to verify icon paths before building a valid `mxGraphModel` payload, and non-Azure diagrams skip icon lookup. A script, `scripts/search_azure2_icons_github.py`, refreshes the icon catalog and needs Python 3 and internet access, though only periodically.
Azure network and infrastructure diagrams get a larger canvas, thick VNet borders, dashed subnet borders, resources placed inside their subnets, protocol and port labels on traffic flows and a traffic legend. Visual guardrails limit diagrams to three or four lanes, a left-to-right main path, numbered stages instead of many edge labels and one icon per major service. A `.drawio` file can be saved as a wrapped mxfile when you want an artifact.
When your agent uses it
- Drawing an Azure architecture or network topology diagram
- Azure icons or shapes are not appearing in a draw.io diagram
- Saving a diagram as a .drawio file from an MCP workflow
Example prompts
- “Draw an Azure hub-and-spoke network diagram with VNets, subnets and firewall traffic flows.”
- “My Azure icons are showing as blank boxes in draw.io, so fix the diagram.”
- “Create a CI/CD pipeline diagram that deploys to Azure and save it as pipeline.drawio.”
Requirements
- A `drawio` server in the workspace MCP config
- Python 3 and internet access to refresh the icon catalog
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- If diagram uses Azure icons: grep references/azure2-complete-catalog.txt to verify icon paths — no scripts needed at runtime.
- If diagram is not Azure-specific: skip icon lookup and create diagram directly.
- For Azure infrastructure/network diagrams: apply Professional Network Topology Patterns (see section below)
- Build a valid mxGraphModel payload using verified icons when applicable.
- Call drawio/create_diagram with the XML.
- If user wants a file artifact, save as .drawio wrapped in ....
- Keep labels concise and explicit (service name + role).
- For Azure diagrams, prefer one icon per major service and use edges for flow semantics (ingress/egress/peering/telemetry).
What it can do on your machine
Read from SKILL.md and the folder at commit 554ac0b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
mcp.draw.ioraw.githubusercontent.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Azure Draw.io MCP Diagrams loads about 3.1k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 70 tokens; SKILL.md has 1,112 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 1,112 words (~3,096 tokens).
“Use this skill to create or update diagrams through the Draw.io MCP tool and to avoid common Azure icon rendering problems.”
- name
- azure-drawio-mcp-diagramming
- metadata.author
- Thomas Thornton
- metadata.version
- 1.0.0
- metadata.last-updated
- 2026-05-19
Files
SKILL.md and 4 other files (scripts, references) in .github/skills/azure-drawio-mcp-diagramming of thomast1906/github-copilot-agent-skills.
- SKILL.md
- references/REFERENCE.md
- references/azure2-complete-catalog.txt
- references/layout-antipatterns.md
- scripts/search_azure2_icons_github.py
Open the folder on GitHubat commit 554ac0b
Compare with similar skills
Azure Draw.io MCP Diagrams next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Azure Draw.io MCP Diagrams this skillthomast1906/github-copilot-agent-skills | 202 | — | ~3.1k | Automated safety check: Pass | None | |
| Azv Diagram Azure SyncAzure/AZVerify | 101 | — | ~3.7k | Automated safety check: Pass | MIT | |
| Azv Diagram Azure Sync DeepAzure/AZVerify | 101 | — | ~3.9k | Automated safety check: Pass | MIT | |
| Azv Sketch To DiagramAzure/AZVerify | 101 | — | ~3.5k | Automated safety check: Pass | MIT | |
| Drawio Azuresparklabx/drawio-ai-kit | 655 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Azv Azure To DiagramAzure/AZVerify | 101 | — | ~5.7k | Automated safety check: Pass | MIT |
Similar skills
- Official
- Official
Azv Diagram Azure Sync Deep
Azure/AZVerify
Deep-compare a Draw.io Azure architecture diagram against a live Azure environment — checks both resource existence AND every tracked configuration property (SKU, size, settings, etc.) against…
- Official
Azv Sketch To Diagram
Azure/AZVerify
Convert a rough sketch or drawing of an Azure architecture into a professional Draw.io diagram using Azure-specific shapes.
Drawio Azure
sparklabx/drawio-ai-kit
A skill your agent uses when the user asks for an Azure architecture diagram — VNet/networking, App Service, AKS, landing zone, multi-region, or any diagram built with Azure service icons.
- Official
Azv Azure To Diagram
Azure/AZVerify
Reverse-engineer a live Azure scope (resource group or filtered subscription) into a professional Draw.io architecture diagram following established AzVerify conventions.
- Official
Azv Bicep Diagram Sync
Azure/AZVerify
Compare Bicep templates against a Draw.io Azure architecture diagram to detect resource-level divergence.
More from thomast1906/github-copilot-agent-skills
All 15 skills in this repoCopilot Skill Creator
thomast1906/github-copilot-agent-skills
Guides creating, updating, reviewing and validating GitHub Copilot agent skills, from deciding whether a skill is the right tool to structuring bundled resources.
Azure API Management Security Review
thomast1906/github-copilot-agent-skills
Audits an Azure API Management setup against the OWASP API Security Top 10 and Azure Security Benchmark, covering policies, network layout and identity.
Azure APIM Policy Authoring
thomast1906/github-copilot-agent-skills
Generates Azure API Management policy XML for authentication, rate limiting, CORS, error handling and transformations, consulting Azure best-practice and documentation tools first.
APIOps Deployment for Azure APIM
thomast1906/github-copilot-agent-skills
Supplies Bicep and Terraform templates, CI/CD pipeline patterns and phased promotion plans for deploying Azure API Management with APIOps workflows.
Azure Pricing Lookup
thomast1906/github-copilot-agent-skills
Looks up live Azure retail prices by SKU, service or region through the Azure MCP pricing tool, estimates template costs and compares regions, price types and savings plans.
Excalidraw MCP Diagramming
thomast1906/github-copilot-agent-skills
Create and edit diagrams on a live Excalidraw canvas using the Excalidraw MCP server.
Related
Categories
Questions about Azure Draw.io MCP Diagrams
What does Azure Draw.io MCP Diagrams do?
Creates and edits architecture diagrams through the Draw.io MCP tool, with guidance for rendering Azure icons correctly and laying out network diagrams. The skill uses the `drawio/create_diagram` MCP tool, which needs a `drawio` server in the workspace MCP config.txt` to verify icon paths before building a valid `mxGraphModel` payload, and non-Azure diagrams skip icon lookup.
When should I use Azure Draw.io MCP Diagrams?
Azure Draw.io MCP Diagrams fits situations like: drawing an Azure architecture or network topology diagram; azure icons or shapes are not appearing in a draw.io diagram; saving a diagram as a .drawio file from an MCP workflow.
How do I install Azure Draw.io MCP Diagrams in Claude Code?
Run `npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a claude-code`. Or copy the skill folder (.github/skills/azure-drawio-mcp-diagramming in thomast1906/github-copilot-agent-skills) into .claude/skills/azure-drawio-mcp-diagramming in your project. Claude Code loads it when a task matches its description.
How do I install Azure Draw.io MCP Diagrams in Codex?
Run `npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a codex`. Or copy the skill folder (.github/skills/azure-drawio-mcp-diagramming in thomast1906/github-copilot-agent-skills) into .agents/skills/azure-drawio-mcp-diagramming in your project. Codex loads it when a task matches its description.
Can I use Azure Draw.io MCP Diagrams in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thomast1906/github-copilot-agent-skills --skill azure-drawio-mcp-diagramming -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/azure-drawio-mcp-diagramming, .gemini/skills/azure-drawio-mcp-diagramming, .github/skills/azure-drawio-mcp-diagramming and .opencode/skills/azure-drawio-mcp-diagramming in your project.
What does Azure Draw.io MCP Diagrams need to run?
Going by SKILL.md and its folder, Azure Draw.io MCP Diagrams needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: A `drawio` server in the workspace MCP config; Python 3 and internet access to refresh the icon catalog.
Does Azure Draw.io MCP Diagrams access the network?
SKILL.md names 2 domains. In commands or code: mcp.draw.io and raw.githubusercontent.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.
Is Azure Draw.io MCP Diagrams safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Azure Draw.io MCP Diagrams use?
No licence was found for Azure Draw.io MCP Diagrams or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Azure Draw.io MCP Diagrams use?
About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.5k tokens, read only when the agent opens those files.
What are the alternatives to Azure Draw.io MCP Diagrams?
Skills that share tags, products or a category with Azure Draw.io MCP Diagrams: Azv Diagram Azure Sync (Azure/AZVerify, 101 stars), Azv Diagram Azure Sync Deep (Azure/AZVerify, 101 stars), Azv Sketch To Diagram (Azure/AZVerify, 101 stars) and Drawio Azure (sparklabx/drawio-ai-kit, 655 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Azure Draw.io MCP Diagrams?
thomast1906 (a GitHub user) maintains it in thomast1906/github-copilot-agent-skills, which has 202 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.
Source: thomast1906/github-copilot-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.