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.