Mermaid Tools Skill

npx degit daymade/claude-code-skills/mermaid-tools ~/.claude/skills/mermaid-tools

mermaid-tools solves a small but persistent pain: Mermaid diagrams in Markdown render fine on GitHub, but break everywhere else (most publishing platforms, exported PDFs, slides, social previews).

What it does

• Scans Markdown for ```mermaid blocks
• Renders each to PNG at configurable resolution
• Preserves diagram titles as filenames
• Outputs at 2x or 3x density for retina displays

Where it shines

• Tech blog posts — most platforms (Medium, Substack, WeChat) don’t render Mermaid
• README → social card — when you want to share a repo’s architecture diagram
• Slide decks — drop the PNG into PowerPoint or Keynote
• Exported PDFs — Mermaid often breaks during export; pre-rendering avoids it

Composes with

• excalidraw-diagram / drawio-diagram — when you need editable output instead
• wechat-article-writer — embed rendered diagrams into articles
• pptx — embed into slide decks

→ Install on GitHub

Use mermaid-tools to scan this Markdown file, find every mermaid block,
and render each as a 2x retina PNG suitable for blog use. Save to
./diagrams/ with filenames matching the diagram titles.