← Back to Skills Marketplace
67
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ai-diagram-generator
Description
AI-powered diagram creation, editing, and format conversion. Generate flowcharts, sequence diagrams, ER diagrams, architecture diagrams and more in Mermaid,...
README (SKILL.md)
Diagram Generator
AI-powered diagram creation, editing, and format conversion from your terminal. Generate flowcharts, sequence diagrams, ER diagrams, architecture diagrams and more in Mermaid, draw.io, PlantUML, and Graphviz formats.
Powered by Evolink.ai
When to Use
- User wants to generate a diagram from a natural language description
- User asks to modify or update an existing diagram file
- User needs to convert a diagram between formats (e.g., Mermaid to draw.io)
- User wants to understand what an existing diagram represents
- User asks to preview or render a diagram locally
- User needs a quick reference for diagram types and format syntax
Quick Start
1. Set your EvoLink API key
export EVOLINK_API_KEY="your-key-here"
Get a free key: evolink.ai/signup
2. Generate a diagram
bash scripts/diagram.sh generate flowchart "user login flow with OAuth and MFA"
3. Preview it
bash scripts/diagram.sh preview login_diagram.mmd
Capabilities
Local Commands (no API key needed)
| Command | Description |
|---|---|
templates |
List all diagram types, formats, and usage examples |
preview \x3Cfile> |
Open diagram in browser (Mermaid HTML, draw.io link, PlantUML URL, Graphviz SVG) |
AI Commands (require EVOLINK_API_KEY)
| Command | Description |
|---|---|
generate \x3Ctype> [--format \x3Cfmt>] "\x3Cdesc>" |
AI generate diagram from natural language description |
edit \x3Cfile> "\x3Cinstruction>" |
AI modify existing diagram file based on instruction |
convert \x3Cfile> --to \x3Cformat> |
AI convert diagram between formats |
explain \x3Cfile> |
AI explain diagram structure in plain language |
Diagram Types
| Type | Description |
|---|---|
flowchart |
Process flows, decision trees, workflows |
sequence |
API calls, service interactions, message flows |
class |
OOP class hierarchies, interfaces, relationships |
er |
Database entity-relationship diagrams |
state |
State machines, lifecycle transitions |
mindmap |
Idea maps, topic hierarchies, brainstorming |
architecture |
System architecture, microservices, cloud infra |
network |
Network topology, server layout, connectivity |
gantt |
Project timelines, task scheduling |
pie |
Data distribution, proportions |
git |
Git branch/merge visualization |
c4 |
C4 model (context, container, component, code) |
Output Formats
| Format | Extension | Best For |
|---|---|---|
mermaid |
.mmd |
Documentation, README files (native GitHub/GitLab rendering) |
drawio |
.drawio |
Architecture diagrams (drag-and-drop editing in diagrams.net) |
plantuml |
.puml |
UML diagrams (rich UML support, sequence diagrams) |
graphviz |
.dot |
Graph/network layouts (automatic layout algorithms) |
Examples
Generate a flowchart
bash scripts/diagram.sh generate flowchart "CI/CD pipeline with build, test, and deploy stages"
Generate an ER diagram in draw.io format
bash scripts/diagram.sh generate er --format drawio "e-commerce database with users, orders, products"
Edit an existing diagram
bash scripts/diagram.sh edit flow.mmd "add error handling branch after validation step"
Convert Mermaid to draw.io
bash scripts/diagram.sh convert flow.mmd --to drawio
Explain a diagram
bash scripts/diagram.sh explain architecture.puml
Preview a Mermaid diagram
bash scripts/diagram.sh preview flow.mmd
Configuration
| Variable | Default | Required | Description |
|---|---|---|---|
EVOLINK_API_KEY |
— | Yes (AI commands) | Your EvoLink API key. Get one free |
EVOLINK_MODEL |
claude-opus-4-6 |
No | Model for AI generation |
Required binaries: python3, curl
Optional: dot (Graphviz) for local SVG rendering in preview command
Security
Data Transmission
AI commands send diagram content to api.evolink.ai for processing by Claude. By setting EVOLINK_API_KEY and using these commands, you consent to this transmission. Data is not stored after the response is returned. The templates and preview commands run entirely locally and never transmit data.
Preview Command
- Mermaid preview generates a local HTML file using the Mermaid.js CDN — no diagram data is sent externally.
- PlantUML preview sends diagram code to
plantuml.comfor rendering. A warning is displayed before opening. - draw.io preview opens the diagrams.net web app — you load the file manually.
- Graphviz preview renders locally via the
dotbinary if installed.
Network Access
api.evolink.ai— AI generation (AI commands only)cdn.jsdelivr.net— Mermaid.js library (preview command, Mermaid format only)plantuml.com— PlantUML rendering (preview command, PlantUML format only)
Persistence & Privilege
Temporary files for API payloads are cleaned up automatically. No credentials or persistent data are stored.
Links
Usage Guidance
This skill sends diagram text and edit instructions to api.evolink.ai when you use AI commands — set EVOLINK_API_KEY only if you trust EvoLink and avoid sending sensitive secrets or proprietary architecture details. Local preview/templates run without network access, but PlantUML preview may contact plantuml.com and Mermaid preview uses a CDN; expect those network calls. Review the README/SKILL.md and test with non-sensitive diagrams first. If you need stricter privacy, do not export or process diagrams containing credentials, API keys, or internal hostnames through the AI commands.
Capability Analysis
Type: OpenClaw Skill
Name: ai-diagram-generator
Version: 1.0.0
The skill contains a shell injection vulnerability in the 'preview' command within 'scripts/diagram.sh'. The script uses an unquoted heredoc to generate a local HTML file and includes the diagram's content via command substitution '$(cat "$file")', leading to a double-evaluation where shell metacharacters (e.g., backticks or $()) inside the diagram file are executed by the host shell. While the tool's stated purpose of generating diagrams via 'api.evolink.ai' is legitimate and data transmission is disclosed, this vulnerability allows for arbitrary code execution if the agent is induced to preview a maliciously crafted diagram file.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (diagram generation, conversion, editing) match the files and runtime behavior: scripts read diagram files, call an AI API, and produce/preview diagram outputs. Required binaries (python3, curl) and EVOLINK_API_KEY are reasonable and required by the script.
Instruction Scope
The SKILL.md and scripts restrict actions to reading user-specified diagram files, creating temporary payload files, and sending them to api.evolink.ai for AI operations. Local-only commands (templates, preview) are documented separately. The instructions do not attempt to read unrelated system files or extraneous environment variables.
Install Mechanism
No network download/install from untrusted URLs is present. The included npm installer copies bundled skill files into a skills/slug directory and writes installation metadata (.clawhub-origin.json and .clawhub/lock.json). This is a standard local install behavior and does not pull arbitrary external code.
Credentials
The only required env var is EVOLINK_API_KEY (primary credential) and an optional EVOLINK_MODEL; both are directly used by the script to authenticate and select a model. There are no unrelated or excessive credential requests.
Persistence & Privilege
Skill is not always-enabled; it is user-invocable and does not require elevated platform privileges. Installer writes its own metadata and lockfile in the workspace, but it does not modify other skills or request system-wide credentials.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ai-diagram-generator - After installation, invoke the skill by name or use
/ai-diagram-generator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Diagram Generator.
- AI-powered creation, editing, and format conversion for diagrams using natural language.
- Supports multiple diagram types: flowchart, sequence, ER, class, state, mindmap, architecture, network, gantt, pie, git, and C4.
- Outputs in Mermaid, draw.io, PlantUML, and Graphviz formats.
- Includes local and AI-assisted commands for generating, editing, converting, explaining, and previewing diagrams.
- Requires EvoLink API key for AI functionality; local previews and templates work offline.
Metadata
Frequently Asked Questions
What is Diagram Generator?
AI-powered diagram creation, editing, and format conversion. Generate flowcharts, sequence diagrams, ER diagrams, architecture diagrams and more in Mermaid,... It is an AI Agent Skill for Claude Code / OpenClaw, with 67 downloads so far.
How do I install Diagram Generator?
Run "/install ai-diagram-generator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Diagram Generator free?
Yes, Diagram Generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Diagram Generator support?
Diagram Generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Diagram Generator?
It is built and maintained by EvolinkAI (@evolinkai); the current version is v1.0.0.
More Skills