diagram-generator · franklee16 — Claude Code skill: what it does, how to install
diagram-generator is a Claude Code skill that creates and edits draw.io, Mermaid, and Excalidraw diagrams from text descriptions.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill diagram-generator -a claude-codeWhat diagram-generator does
This skill turns natural language requests into structured JSON schemas for various visual representations: flowcharts, sequence diagrams, class models, ER diagrams, mind maps, and network topologies. It also inspects existing .drawio, .mmd, or Excalidraw files to apply targeted edits directly.
File generation relies strictly on mcp-diagram-generator. Without adding this MCP server to your ~/.claude.json or project .claude.json via npx, Claude Code fails with missing tool errors during diagram creation.
Generated files are stored under diagrams/{format}/ within the project. Default directory settings live in .diagram-config.json, which lets you point target formats to custom project folders.
What it helps with
- generate network topologies or flowcharts in draw.io format
- build database ER diagrams using Mermaid syntax
- sketch service architecture models for Excalidraw
- modify existing
.drawioor.mmddiagrams with conversational edits
Example prompts for the agent
- Create a draw.io network topology with web, backend, and database zones
- Generate an ER diagram for an e-commerce platform using mermaid format
- Update
diagrams/drawio/architecture.drawioto include a Redis cache layer
How to install diagram-generator
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill diagram-generator -a claude-code2Manually: put the files in place
~/.claude/skills/diagram-generator-1.1.1/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/diagram-generator-1.1.1/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill diagram-generator -a codex2Manually: put the files in place
.agents/skills/diagram-generator-1.1.1/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill diagram-generator -a cursor2Manually: put the files in place
.cursor/skills/diagram-generator-1.1.1/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills output-tools/diagram-generator-1.1.1/SKILL.md2Manually: put the files in place
.github/skills/diagram-generator-1.1.1/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill diagram-generator -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path output-tools/diagram-generator-1.1.1Manually: put the files in place
.devin/skills/diagram-generator-1.1.1/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about diagram-generator
How do I install diagram-generator in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill diagram-generator-1.1.1 -a claude-code in your terminal. Then add the mcp-diagram-generator entry to mcpServers in your ~/.claude.json file.
Which diagram formats does this skill support?
It supports draw.io (.drawio), Mermaid (.mmd), and Excalidraw files. It works with sequence flows, architecture charts, ER models, and network topology layouts.
What causes the Tool not found error?
This issue happens when the mcp-diagram-generator server is missing from configuration or Claude Code has not been restarted. Add the server under mcpServers and restart Claude Code.
Similar skills
All skills for Writing and docs →diagram-generator by other authors comes first.