Mermaid cli

Skill colinwilliams91/gaitor-orchestrator-cli/packages/cli/templates/skills/mermaid-cli

Render Mermaid diagram definitions to image files (SVG, PNG, PDF) from the command line. Use when asked to generate or convert Mermaid diagrams to visual output files.From its SKILL.md

Install

npx -y skills add colinwilliams91/gaitor-orchestrator-cli --skill mermaid-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 8 commands, including `npm run diagram -- -i input.mmd -o output.svg` and 7 more.

SKILL.md

2.3 KB, 593 tokens by cl100k_base, as published. Nobody here has run it

Diagram Rendering with mermaid-cli

Quick start

# via the project npm script (-- passes args to mmdc)
npm run diagram -- -i input.mmd -o output.svg

# or directly via npx (uses local devDependency)
npx mmdc -i input.mmd -o output.svg

Commands

Convert a file

# SVG (default)
mmdc -i diagram.mmd -o diagram.svg

# PNG
mmdc -i diagram.mmd -o diagram.png

# PDF
mmdc -i diagram.mmd -o diagram.pdf

Read from stdin

echo "graph LR; A-->B" | mmdc -i - -o out.svg

Common options

Flag	Long form	Description
`-i`	`--input`	Input `.mmd` file, or `-` for stdin
`-o`	`--output`	Output file path (`.svg`, `.png`, `.pdf`)
`-t`	`--theme`	Theme: `default` \| `dark` \| `forest` \| `neutral`
`-b`	`--backgroundColor`	Background colour (`white`, `transparent`, `#ffffff`)
`-w`	`--width`	Canvas width in pixels (PNG only)
`-H`	`--height`	Canvas height in pixels (PNG only)
`-s`	`--scale`	Scale factor for PNG (default: `1`)
`-f`	`--configFile`	Path to Mermaid config JSON
`-C`	`--cssFile`	Path to custom CSS file

Examples

# Dark-themed PNG at 1200 px wide
mmdc -i architecture.mmd -o architecture.png -t dark -w 1200

# Transparent-background SVG
mmdc -i flow.mmd -o flow.svg -b transparent

# Neutral theme with custom config
mmdc -i sequence.mmd -o sequence.svg -t neutral -f mermaid.config.json

Installation

@mermaid-js/mermaid-cli is a devDependency of this project. After npm install, invoke the binary via npx:

npx --no-install mmdc --version

If working outside this project and the command is not yet available locally:

npm install --save-dev @mermaid-js/mermaid-cli@latest

Reference

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.