Skip to content

GuruDevvv/my-claude-skills / external/mermaid-tools

mermaid-tools

Verified

Extracts Mermaid diagrams from markdown files and generates high-quality PNG images using bundled scripts. Activates when working with Mermaid diagrams, converting diagrams to PNG, extracting diagrams from markdown, or processing markdown files with embedded Mermaid code.

# mermaid-tools

Pulls Mermaid diagrams out of a Markdown file and renders them to high-resolution PNG.

## When to use

When a diagram has to live somewhere that does not render Mermaid — a Word document, a slide, a PDF,
a Telegram message. Chat and artifacts render it natively; everything else shows raw code.

## What's inside

One command per file: every diagram extracted in order, numbered 01, 02, ..., saved beside its source
along with the diagram code. Size and scale are configurable, with presets for presentation and print
(4-5x scale).

## Requirements

`npm install -g @mermaid-js/mermaid-cli` — a one-off, and it pulls its own browser (~150 MB).

## Patched — this is not upstream

Upstream `scripts/extract-and-generate.sh` hard-requires Chrome at `/usr/bin/google-chrome-stable`
(a WSL2/Ubuntu path) and exits if it is absent — so it never ran on Windows, even though the renderer
itself works there fine.

Now, if that path does not exist, `PUPPETEER_EXECUTABLE_PATH` is simply not set and mermaid-cli falls
back to its own bundled browser. Verified on Windows, including Cyrillic labels.

## Source

**Not my work.** By daymade — [daymade/claude-code-skills](https://github.com/daymade/claude-code-skills), `daymade-docs/mermaid-tools/`

MIT. Full licence text: [`../licenses/`](../licenses/). Prefer installing from upstream — that copy is maintained, this one is a snapshot.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall