Diagram Generator

AI-powered diagram creation, editing, and format conversion. Generate flowcharts, sequence diagrams, ER diagrams, architecture diagrams and more in Mermaid,...

Security Scan

The skill's code, instructions, and requested environment variables align with a diagram-generation tool that calls the EvoLink API; nothing in the package requests unrelated credentials or performs unexpected actions.

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.

Assessment

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.

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 <file>	Open diagram in browser (Mermaid HTML, draw.io link, PlantUML URL, Graphviz SVG)

AI Commands (require EVOLINK_API_KEY)

Command	Description
generate <type> [--format <fmt>] "<desc>"	AI generate diagram from natural language description
edit <file> "<instruction>"	AI modify existing diagram file based on instruction
convert <file> --to <format>	AI convert diagram between formats
explain <file>	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.com for 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 dot binary 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

• GitHub
• EvoLink API
• Community
• Support