Individual skill
pretty-mermaid
Generate and render Mermaid diagrams for architecture docs, READMEs, PRs, terminals, chats, and CI as themed SVG, PNG, or ASCII/Unicode art. Use this skill whenever the user provides Mermaid code or .mmd files; asks for a flowchart, sequence/state/class diagram, ERD, XY chart, or architecture/workflow/data-model visualization; or wants to beautify, theme, batch-convert, or make a diagram terminal-friendly. Runs locally without a browser or DOM, with 15 built-in themes and custom colors.
SKILL.md
Source commit e234ab73c2992f03c36db04fd55ebb90abca9c45
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,573
- Repository last updated
- Aug 22, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- mermaid Repository topic
- skills Repository topic
- agent-skills Repository topic
- ai-agents Repository topic
- ascii-art Repository topic
- claude-code Repository topic
- codex Repository topic
- cursor Repository topic
- diagram-generator Repository topic
- documentation Repository topic
- data Derived category
- engineering Derived category
- operations Derived category
- docs Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
.github/ISSUE_TEMPLATE/bug_report.ymlasset · 1,845 bytes.github/ISSUE_TEMPLATE/config.ymlasset · 28 bytes.github/ISSUE_TEMPLATE/feature_request.ymlasset · 1,044 bytes.github/PULL_REQUEST_TEMPLATE.mddoc · 508 bytes.github/release.ymlasset · 421 bytes.github/workflows/ci.ymlasset · 1,360 bytes.github/workflows/release.ymlasset · 1,239 bytes.gitignoreasset · 570 bytesCHANGELOG.mddoc · 1,389 bytesCODE_OF_CONDUCT.mddoc · 3,925 bytesCONTRIBUTING.mddoc · 1,776 bytesLICENSEasset · 1,087 bytesREADME.mddoc · 5,147 bytesREADME_CN.mddoc · 5,106 bytesREADME_JA.mddoc · 5,748 bytesRELEASING.mddoc · 1,220 bytesSECURITY.mddoc · 704 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesSKILL.mdcore · 7,802 bytesassets/example_diagrams/class.mmdasset · 515 bytesassets/example_diagrams/er.mmdasset · 584 bytesassets/example_diagrams/flowchart.mmdasset · 253 bytesassets/example_diagrams/sequence.mmdasset · 295 bytesassets/example_diagrams/state.mmdasset · 225 bytesassets/example_diagrams/xychart.mmdasset · 206 bytesassets/social-preview.pngasset · 828,104 bytesassets/theme_gallery/catppuccin-latte.svgasset · 5,922 bytesassets/theme_gallery/catppuccin-mocha.svgasset · 5,922 bytesassets/theme_gallery/dracula.svgasset · 5,922 bytesassets/theme_gallery/github-dark.svgasset · 5,922 bytesassets/theme_gallery/github-light.svgasset · 5,922 bytesassets/theme_gallery/nord-light.svgasset · 5,922 bytesassets/theme_gallery/nord.svgasset · 5,922 bytesassets/theme_gallery/one-dark.svgasset · 5,922 bytesassets/theme_gallery/solarized-dark.svgasset · 5,922 bytesassets/theme_gallery/solarized-light.svgasset · 5,922 bytesassets/theme_gallery/source.mmdasset · 176 bytesassets/theme_gallery/tokyo-night-light.svgasset · 5,922 bytesassets/theme_gallery/tokyo-night-storm.svgasset · 5,922 bytesassets/theme_gallery/tokyo-night.svgasset · 5,922 bytesassets/theme_gallery/zinc-dark.svgasset · 5,874 bytesassets/theme_gallery/zinc-light.svgasset · 5,874 bytesdocs/THEME_GALLERY.mddoc · 2,193 bytespackage-lock.jsonasset · 8,675 bytespackage.jsonruns · 555 bytesreferences/DIAGRAM_TYPES.mddoc · 8,025 bytesreferences/THEMES.mddoc · 9,404 bytesreferences/api_reference.mddoc · 2,457 bytesscripts/batch.mjsruns · 10,284 bytesscripts/generate-theme-gallery.mjsruns · 1,214 bytesscripts/png.mjsruns · 10,681 bytesscripts/render.mjsruns · 8,754 bytesscripts/smoke-test.mjsruns · 11,006 bytesscripts/themes.mjsruns · 1,644 bytesscripts/validate-docs.mjsruns · 2,774 bytes
Read excerpt
# Pretty Mermaid
Create or render Mermaid diagrams with the bundled Node.js CLI. Use SVG for scalable documentation, PNG for sharing or raster-only consumers, and ASCII or Unicode for terminals and plain text.
## Working directory
Treat the directory containing this file as `<skill-root>`. Run bundled scripts from that directory, or invoke them with absolute paths. Keep user source and rendered output in the user's requested location; do not copy the renderer into their project.
## Workflow
1. Determine whether the user supplied Mermaid source or needs a diagram authored from prose.
2. Choose the diagram type and output format from the tables below.
3. Read only the relevant reference file when syntax, theme selection, or API behavior needs more detail.
4. Save new source as a `.mmd` file, preserving user terminology and relationships.