Skip to main content
skill CX Codex

diagram-generator · oimiragieo — Claude Code skill: Mermaid diagrams and HTML export

diagram-generator turns code and docs into Mermaid diagrams: architecture, schemas, data flows. Any diagram can come out as one standalone HTML page.

no license 146 installs ★ 45 updated 2026-07-14

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oimiragieo/agent-studio --skill diagram-generator -a claude-code
Open on GitHub

What diagram-generator does

The skill writes Mermaid diagrams: flowcharts, sequence and class diagrams, state machines, ER schemas, Gantt charts, pie, mindmap, timeline, gitGraph, kanban and quadrant charts. It reads source files and docs with Read, Glob and Grep, then saves the result with Write.

HTML is the second output mode. You get one self-contained page that pulls Mermaid.js from a CDN, carries a theme toggle and opens dark. Files land in .claude/context/artifacts/diagrams/, with the .mmd source and the .html next to it.

Two caps matter on a big repo: 200 nodes per diagram and 1000 files per run, so a monolith gets split by subsystem with an overview drawn first. Only Mermaid syntax is accepted, so PlantUML and ASCII art are out. Nothing is written outside .claude/context/artifacts/diagrams/ either, which means moving diagrams into your docs is a manual step.

What it helps with

  • draw an ER diagram from the tables in prisma/schema.prisma
  • map a login flow as flowchart TB
  • export a schema diagram to a single HTML page with a theme toggle
  • visualise branch history as gitGraph
  • split a large service into overview and detail diagrams

Example prompts for the agent

  • Draw a flowchart TB of the login flow in src/auth/, keep it under 200 nodes.
  • Turn prisma/schema.prisma into an ER diagram and export it as HTML.
  • Diagram src/api/ as a sequence of one request, then a component view of the whole folder.

How to install diagram-generator

1Skills CLI (Vercel)

npx skills add oimiragieo/agent-studio --skill diagram-generator -a claude-code

2Manually: put the files in place

~/.claude/skills/diagram-generator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/diagram-generator/

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 oimiragieo/agent-studio --skill diagram-generator -a claude-code. The skill file ends up at ~/.claude/skills/diagram-generator/SKILL.md.

What does diagram-generator do?

It builds Mermaid diagrams from code and documentation: architecture, ER schemas, sequences, state machines, timelines. Any of them can be saved as a standalone HTML page with a dark/light toggle.

Can it export a diagram as a standalone HTML file?

Yes. The HTML mode embeds Mermaid.js from a CDN in one file, opens in dark mode and includes a button that switches the theme.

Similar skills

All skills for Agent setup: memory, context, orchestration →

diagram-generator by other authors comes first.

diagram-generator zhaoxuya520 diagram-generator is a Claude Code skill that generates, checks, and renders diagrams from text, code, schemas, and tables for architecture, process, and UML modeling. CX Codex +1 1,500installs diagram-generator franklee16 diagram-generator is a Claude Code skill that creates and edits draw.io, Mermaid, and Excalidraw diagrams from text descriptions. CX Codex +1 ★ 240repo stars diagram-design cathrynlavery diagram-design is a Claude Code skill that builds editorial diagrams as standalone HTML files with inline SVG. It covers 51 visual types under a project-specific style guide. CX Codex +1 30,900installs diagram-architect davila7 diagram-architect is a Claude Code subagent that creates technical diagrams in ASCII, Mermaid, PlantUML, and Draw.io. It activates for architecture views, database schemas, process flows, and dependency maps. CX Codex 1,178installs architecture-diagram-creator mhattingpete architecture-diagram-creator creates a standalone HTML architecture document with SVG data flow diagrams and project structure. Helpful when you need to document system layers or explain processing pipelines. CX Codex +1 524installs agent-mermaid-diagram-specialist softaworks agent-mermaid-diagram-specialist — a plugin that generates Mermaid diagrams: flowcharts, sequence diagrams, ERDs, and architecture visualizations. Saves time when you need to sketch out processes, data relationships, or system interactions. ★ 2,707repo stars coco-diagram coco-research coco-diagram is a skill that turns system descriptions into diagrams and redraws .drawio and Mermaid sources. It makes architecture or processes easier to follow visually. CX Codex +1 ★ 328repo stars diagram-design-editorial reason-machines diagram-design-editorial — a skill that turns a short description into an HTML+SVG diagram for posts and docs. Thirteen types, no Mermaid, no build step, styling matched to your site. CX Codex +1 440installs

From the same set8

Project sponsors

Companies that keep this analytics open