Agent skill

Drawio MCP Diagramming

by thomast1906 in thomast1906/github-copilot-agent-skills

Create and edit diagrams using the Draw.io MCP server — any shape, any vendor.

No licenceAuto-check passedDevelopment

Install Drawio MCP Diagramming

skills CLI
$ npx skills add thomast1906/github-copilot-agent-skills --skill drawio-mcp-diagramming -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thomast1906/github-copilot-agent-skills drawio-mcp-diagramming --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ 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/drawio-mcp-diagramming .claude/skills/drawio-mcp-diagramming && rm -rf skills-src

Use ~/.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/

Facts

Skill name
drawio-mcp-diagramming
GitHub stars
202
Token cost
~6.6k tokens
SKILL.md length
3,120 words
Files
8 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
None found

At a glance

Create and edit diagrams using the Draw.io MCP server — any shape, any vendor.

  • Works in 12 steps: Identify the input format and diagram type → Use drawio/search_shapes for any… → When to use search_shapes vs skip it —… → …
  • : draw me a diagram
  • SKILL.md covers When to Use, Required Tooling, Recommended Workflow and Input Format Quick Reference, plus 8 more sections
  • Calls npx; reaches mcp.draw.io

What it does

Drawio MCP Diagramming is an agent skill from thomast1906/github-copilot-agent-skills. Create and edit diagrams using the Draw.io MCP server — any shape, any vendor. USE FOR: draw me a diagram, create an architecture diagram, add Azure/AWS/GCP/Cisco/Kubernetes icons to a diagram, convert Mermaid to draw.io, fix overlapping arrows, edit a .drawio file, network topology diagrams, CI/CD pipeline diagrams, auth flow diagrams. Supports XML, Mermaid, and CSV. Uses drawio/searchshapes to find any of 10,000+ shapes across all vendor and icon libraries. DO NOT USE FOR: Excalidraw output (use…

Its SKILL.md is about 6.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/REFERENCE.md`, `references/aws.md` and `references/azure.md`).

It sits in Development, covering Diagrams. It works with draw.io, Model Context Protocol, Mermaid and Amazon Web Services. The repository describes itself as: Repo containing my GitHub Copilot Agent & Skills - continually experimenting!

When your agent uses it

  • : draw me a diagram
  • Create an architecture diagram
  • Add Azure/AWS/GCP/Cisco/Kubernetes icons to a diagram
  • Convert Mermaid to draw.io

Example prompts

  • “/drawio-mcp-diagramming”

Requirements

  • Node.js
  • Docker

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. Identify the input format and diagram type
  2. Use drawio/search_shapes for any non-geometric shape — it searches all 10,000+ shapes across every draw.io library and returns…
  3. When to use search_shapes vs skip it — if a shape has a recognised name, brand, or product identity, always look it up via search_shapes…
  4. Nest groupings with real containers, not stacked rectangles — for any diagram with hierarchy (VNet → Subnet → resource, VPC → AZ →…
  5. Keep labels unique and sparse — if several edges say the same thing, collapse them into one labelled flow or a single note box. Do not…
  6. For cloud infrastructure diagrams, load the vendor reference — read references/azure.md for anything with VNets, subnets, or Azure icons…
  7. Build the payload
  8. Call the appropriate tool
  9. Decide the layout pass before writing XML, then let it route the edges
  10. If the user wants a file artifact, save as .drawio wrapped in .... Read references/standalone-file-requirements.md before writing any…
  11. Keep labels concise and explicit (service name + role).
  12. Prefer one icon per major component or service; use edges for flow semantics (ingress/egress/dependency/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

    Shell commands in SKILL.md call:

    • npx

    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.io

    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

Drawio MCP Diagramming loads about 6.6k tokens when it runs, and up to ~24k if it reads all its reference files. Until then it costs about 140 tokens; SKILL.md has 3,120 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~140
When it runs · the whole SKILL.md, loaded when a task matches
~6.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~24k

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); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 3,120 words (~6,606 tokens).

“Create or update diagrams via the Draw.io MCP server. Before generating XML, read references/xml-authoring-rules.md — hard constraints, container rules, and edge routing guidance that prevent the most common rendering failures. For layout anti-pattern fixes, see references/layout-antipatterns.md. For cloud topology conventions…”

— opening of SKILL.md by thomast1906
name
drawio-mcp-diagramming
metadata.author
Thomas Thornton
metadata.version
1.2.0
metadata.last-updated
2026-10-07

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (references) in .github/skills/drawio-mcp-diagramming of thomast1906/github-copilot-agent-skills.

  • SKILL.md
  • references/REFERENCE.md
  • references/aws.md
  • references/azure.md
  • references/gcp.md
  • references/layout-antipatterns.md
  • references/standalone-file-requirements.md
  • references/xml-authoring-rules.md

Open the folder on GitHubat commit 554ac0b

Compare with similar skills

Drawio MCP Diagramming 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.

Drawio MCP Diagramming compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Drawio MCP Diagramming this skillthomast1906/github-copilot-agent-skills202—~6.6kAutomated safety check: PassNone
Terravision Cloud Diagramspatrickchugh/terravision1.6k—~5.6kAutomated safety check: NotesAGPL-3.0-only
Architecture DiagramMathews-Tom/armory329—~4.8kAutomated safety check: PassMIT
Azv Azure To DiagramAzure/AZVerify101—~5.7kAutomated safety check: PassMIT
Drawiobahayonghang/drawio-skills287—~4.1kAutomated safety check: NotesMIT
Azv Diagram Azure SyncAzure/AZVerify101—~3.7kAutomated safety check: PassMIT

Similar skills

  • Terravision Cloud Diagrams

    patrickchugh/terravision

    Draw cloud architecture diagrams for AWS, Azure or GCP with the official provider icon sets, using TerraVision.

    1.6k GitHub stars~5.6k tokensUpdated 4 days ago
    DevOps & CloudAuto-check: notes
  • Architecture Diagram

    Mathews-Tom/armory

    Generate architecture diagrams as fully editable SVG with native AWS, Azure, and GCP icons for cloud diagrams, or hand-drawn generic icons for everything else.

    329 GitHub stars~4.8k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Azv Azure To Diagram

    Azure/AZVerify

    Official

    Reverse-engineer a live Azure scope (resource group or filtered subscription) into a professional Draw.io architecture diagram following established AzVerify conventions.

    101 GitHub stars~5.7k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Drawio

    bahayonghang/drawio-skills

    Create, edit, replicate, import, and export draw.io diagrams with an offline YAML-first workflow: architecture, network topologies, flowcharts, UML/ER, org charts, Mermaid/CSV conversion, existing…

    287 GitHub stars~4.1k tokensUpdated 1 mo ago
    DevelopmentAuto-check: notes
  • Official

    Compare a Draw.io Azure architecture diagram against a live Azure environment to detect drift.

    101 GitHub stars~3.7k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Official

    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…

    101 GitHub stars~3.9k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

More from thomast1906/github-copilot-agent-skills

All 15 skills in this repo
  • Copilot 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.

    202 GitHub stars~4.1k tokensUpdated 4 days ago
    Auto-check passed
  • 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.

    202 GitHub stars~3.1k tokensUpdated 4 days ago
    Auto-check passed
  • 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.

    202 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • 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.

    202 GitHub stars~3.6k tokensUpdated 4 days ago
    Auto-check passed
  • Azure Draw.io MCP Diagrams

    thomast1906/github-copilot-agent-skills

    Creates and edits architecture diagrams through the Draw.io MCP tool, with guidance for rendering Azure icons correctly and laying out network diagrams.

    202 GitHub stars~3.1k tokensUpdated 4 days ago
    Auto-check passed
  • 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.

    202 GitHub stars~4.9k tokensUpdated 4 days ago
    Auto-check passed

Questions about Drawio MCP Diagramming

What does Drawio MCP Diagramming do?

Create and edit diagrams using the Draw.io MCP server — any shape, any vendor. Drawio MCP Diagramming is an agent skill from thomast1906/github-copilot-agent-skills.io MCP server — any shape, any vendor.

When should I use Drawio MCP Diagramming?

Drawio MCP Diagramming fits situations like: : draw me a diagram; create an architecture diagram; add Azure/AWS/GCP/Cisco/Kubernetes icons to a diagram; convert Mermaid to draw.io.

How do I install Drawio MCP Diagramming in Claude Code?

Run `npx skills add thomast1906/github-copilot-agent-skills --skill drawio-mcp-diagramming -a claude-code`. Or copy the skill folder (.github/skills/drawio-mcp-diagramming in thomast1906/github-copilot-agent-skills) into .claude/skills/drawio-mcp-diagramming in your project. Claude Code loads it when a task matches its description.

How do I install Drawio MCP Diagramming in Codex?

Run `npx skills add thomast1906/github-copilot-agent-skills --skill drawio-mcp-diagramming -a codex`. Or copy the skill folder (.github/skills/drawio-mcp-diagramming in thomast1906/github-copilot-agent-skills) into .agents/skills/drawio-mcp-diagramming in your project. Codex loads it when a task matches its description.

Can I use Drawio MCP Diagramming 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 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/drawio-mcp-diagramming, .gemini/skills/drawio-mcp-diagramming, .github/skills/drawio-mcp-diagramming and .opencode/skills/drawio-mcp-diagramming in your project.

What does Drawio MCP Diagramming need to run?

Going by SKILL.md and its folder, Drawio MCP Diagramming needs the command-line tools its instructions call (npx). Our summary lists: Node.js; Docker.

Does Drawio MCP Diagramming access the network?

SKILL.md names 1 domain. In commands or code: mcp.draw.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Drawio MCP Diagramming 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. Review the folder before installing.

What licence does Drawio MCP Diagramming use?

No licence was found for Drawio MCP Diagramming or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Drawio MCP Diagramming use?

About 6.6k tokens (SKILL.md is roughly 26k 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 18k tokens, read only when the agent opens those files.

What are the alternatives to Drawio MCP Diagramming?

Skills that share tags, products or a category with Drawio MCP Diagramming: Terravision Cloud Diagrams (patrickchugh/terravision, 1.6k stars), Architecture Diagram (Mathews-Tom/armory, 329 stars), Azv Azure To Diagram (Azure/AZVerify, 101 stars) and Drawio (bahayonghang/drawio-skills, 287 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Drawio MCP Diagramming?

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.