imxv/Pretty-mermaid-skills

AI Agent Skill to generate and render beautiful Mermaid diagrams as SVG or terminal ASCII — 15 themes, 6 diagram types, batch CLI, no browser.

What it solves

It allows AI agents and developers to convert Mermaid diagram source code into high-quality visual formats (SVG and PNG) or terminal-friendly ASCII/Unicode text without needing a web browser or a DOM environment.

How it works

The tool renders Mermaid source locally using Node.js, bypassing the need for Chromium or Puppeteer. It supports batch parallel rendering and provides a variety of built-in themes to style the output.

Who it’s for

It is designed for AI coding assistants (such as Claude Code, Cursor, and Gemini CLI) and developers who need to generate diagrams programmatically or within a terminal environment.

Highlights

  • Multi-format output: Generates polished SVGs, shareable PNGs, and ASCII/Unicode for terminals.
  • Browser-less rendering: Operates entirely locally without requiring a browser.
  • Six diagram types: Supports Flowcharts, Sequence, State, Class, ER, and XY charts.
  • Extensive styling: Includes 15 built-in themes (e.g., Tokyo Night, Dracula, Catppuccin) and custom color support.
  • AI Integration: Specifically optimized for use with AI agents and coding environments.

Related

  • Project
    zenbu-labs/terminal-browser

    A web browser that runs inside the terminal using the kitty graphics protocol, enabling developers and AI agents to interact with the web without leaving the command line.

  • Project
    Vrun-design/openflowkit

    An open-source, local-first diagramming studio that combines a visual canvas with bidirectional diagram-as-code and AI generation to create technical architecture flows.

  • Project
    google-gemini/gemini-cli

    An open-source AI agent for the terminal that provides direct access to Gemini models for code analysis, automation, and system integration.

  • Project
    Agents365-ai/drawio-skill

    A tool that converts natural language, source code, and infrastructure configurations into professional, editable .drawio architecture diagrams with automated layout and synchronization.

  • Project
    docmd-io/docmd

    A documentation generator that compiles a single Markdown source into a static website, AI context files, and agent protocols for both human and machine consumption.