imxv/pretty-mermaid-skills

Overview

This skill renders beautiful Mermaid diagrams as SVG or ASCII art using the beautiful-mermaid library. It supports 15+ themes, five diagram types (flowchart, sequence, state, class, ER), and fast single-file or batch rendering. Use it to produce web-ready SVGs or terminal-friendly ASCII diagrams quickly and consistently.

How this skill works

Provide Mermaid code or a .mmd file and the renderer converts it to SVG or ASCII using selected theme and options (colors, fonts, transparency). It can process single files or entire directories in parallel, and offers fine-grained options like custom colors, padding, pure-ASCII output, and worker counts for performance. Outputs are optimized for embedding in docs, slides, or plain-text environments.

When to use it

• You ask to render a Mermaid diagram or supply .mmd content
• You need to create a flowchart, sequence, state, class, or ER diagram
• You want to apply a specific theme or beautify an existing diagram
• You need to batch-process many diagrams for docs or CI
• You want a terminal-friendly ASCII version for README or logs
• You need visualizations for architecture, workflows, or data models

Best practices

• Start from provided templates for common diagram types and iterate with small changes
• Render both SVG (for docs) and ASCII (for READMEs) when sharing across formats
• Use themes like tokyo-night or github-dark for technical documentation and zinc-light for projector slides
• Batch-render 3+ diagrams with multiple workers to save time; keep diagrams under ~50 nodes for best performance
• Apply theme and visual tweaks (transparent background or custom fonts) as the last step before final export

Example use cases

• Generate a professional architecture SVG for project documentation using github-dark
• Create an API sequence diagram and export as SVG for inclusion in design docs
• Render a database ER diagram with dracula for developer-facing schema docs
• Produce ASCII diagrams for terminal README previews or CI logs
• Batch-render an entire diagrams directory into svg and ascii outputs for a release