mermaid

Generate Mermaid diagrams from textual context with Emacs integration.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/benonions/dotfiles --skill mermaid-benonions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mermaid
Source: https://github.com/benonions/dotfiles/tree/main/codex/.codex/skills/community/emacs-skills/mermaid
Command: npx skills add https://github.com/benonions/dotfiles --skill mermaid-benonions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mmdc, emacs, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of visual diagrams from textual context, making complex information easier to understand and communicate.

Core Features & Use Cases

  • Diagram Generation: Creates diagrams (e.g., sequence, flowchart) from provided text using the Mermaid syntax.
  • Contextualization: Derives diagrammable data from the current interaction context.
  • Customization: Allows for theming and styling based on Emacs environment settings (foreground color, background mode).
  • Use Case: Quickly visualize a system's interaction flow or a process's steps directly within your workflow without leaving your Emacs environment.

Quick Start

Use the mermaid skill to create a sequence diagram from the recent conversation history.

Frequently Asked Questions about mermaid

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate diagrams from textual context in Emacs?

To generate diagrams from textual context in Emacs, this Skill uses the Mermaid syntax to derive visual representations of interactions and processes. It automatically queries your Emacs environment settings to apply matching themes and renders the output using the mmdc tool.

What is the best way to visualize system architecture without leaving my workflow?

The best way to visualize system architecture without leaving your workflow is generating Mermaid diagrams directly from textual context. This Skill automates rendering sequence and flowchart diagrams using Emacs integration, keeping the entire process within your current environment.

Do I need mmdc and Emacs to render Mermaid diagrams?

Yes, you need both Emacs and mmdc to render Mermaid diagrams with this Skill. Emacs is required to query environment settings for theming, while mmdc handles the actual diagram rendering with dynamic Chromium path resolution.

Can I customize diagram theming based on my Emacs environment settings?

Yes, you can customize diagram theming based on your Emacs environment settings. The Skill queries your Emacs client for foreground color and background mode to apply matching visual styling to the generated Mermaid diagrams.

Why does diagram rendering fail when generating Mermaid visualizations?

Diagram rendering fails when generating Mermaid visualizations if the Chromium path is not correctly resolved or if Emacs and mmdc dependencies are missing. The Skill requires dynamic Chromium path resolution and a connected Emacs client to execute properly.