diagram-help

Guide Mermaid and SVG diagram rendering across tools like mmdc and rsvg-convert.

2|Updated Jun 15, 2026
One-click install
npx skills add https://github.com/jmerkow/my-agentic-stuff --skill diagram-help
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagram-help
Source: https://github.com/jmerkow/my-agentic-stuff/tree/main/skills/diagram-help
Command: npx skills add https://github.com/jmerkow/my-agentic-stuff --skill diagram-help

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill offers a concise reference to the nuances of Mermaid and SVG diagram rendering, helping users make informed decisions when choosing the right diagram tool for the task.

Core Features & Use Cases

  • Decision Making: Helps users choose between Mermaid, Mermaid to SVG, and direct SVG for diagram creation.
  • Rendering Gotchas: Offers tips on rendering reliability across different tools like mmdc, rsvg-convert, PNG, and PowerPoint.
  • Use Case: When creating diagrams for presentations that require a specific rendering method to ensure clarity and fidelity.

Quick Start

View the diagram rendering best practices for Mermaid and SVG diagrams.

Frequently Asked Questions about diagram-help

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

FAQPage Schema
What is the best way to render Mermaid diagrams for technical documents?▼

Rendering Mermaid diagrams reliably involves choosing between direct Mermaid, converting Mermaid to SVG, or using direct SVG, depending on whether the output targets technical documents or presentations.

How do I convert Mermaid diagrams to SVG for presentations?▼

Converting Mermaid to SVG using mmdc addresses compatibility issues, ensuring diagrams maintain clarity and fidelity when imported into presentation tools like PowerPoint.

Does PowerPoint support Mermaid diagram rendering directly?▼

Direct Mermaid rendering in PowerPoint often faces compatibility issues; converting Mermaid to SVG via mmdc first ensures reliable display and visual fidelity.

Why does my Mermaid diagram rendering fail with rsvg-convert?▼

Rendering failures with rsvg-convert often stem from SVG compatibility gotchas; reviewing diagram rendering best practices helps identify specific tool limitations and ensure reliable output.

When should I use direct SVG instead of Mermaid for diagram creation?▼

Use direct SVG instead of Mermaid when you need maximum rendering reliability across varied tools like rsvg-convert or PNG exporters, bypassing Mermaid's specific compatibility limitations.