mermaid
by jarekbird
PDF & DocumentsBrief
Generate diagrams from text using [Mermaid](https://mermaid.js.org/).
Description
What This Skill Does
Converts Mermaid diagram syntax into rendered PNG, SVG, or PDF images using the mmdc CLI. Supports 12 diagram types including flowcharts, sequence diagrams, ER diagrams, and Git graphs. Output themes and resolution are configurable.
Produces image files directly from text syntax without requiring a browser or design tool.
When to Use It
- Visualizing a database schema as an ER diagram
- Documenting an API authentication flow as a sequence diagram
- Mapping out a project timeline with a Gantt chart
- Rendering a system architecture overview for a README
- Generating a Git branch history diagram
Example Workflow
User asks: draw a sequence diagram showing a login flow with JWT
- 1
Determine sequenceDiagram is the appropriate Mermaid type
- 2
Write the Mermaid syntax to /tmp/mermaid-login.mmd
- 3
Run mmdc -i /tmp/mermaid-login.mmd -o /tmp/mermaid-login.png -t dark -b transparent -s 2
- 4
Display the rendered image to the user via Read tool
- 5
Remove temp files
PNG image of the login sequence diagram with dark theme
Installation
clawhub install jarekbird/mermaidRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.