Validates Mermaid diagrams by parsing and rendering them with the official mermaid-cli.
npx skills add https://github.com/MaxWolf-01/agents --skill mermaid-maxwolf-01
Please help me install this Agent Skill. Skill: mermaid Source: https://github.com/MaxWolf-01/agents/tree/main/mx/skills/mermaid Command: npx skills add https://github.com/MaxWolf-01/agents --skill mermaid-maxwolf-01
.mmd files with @mermaid-js/mermaid-cli, surfacing the parser's exact error messages. - ASCII Preview: Renders a text-based preview of the diagram via beautiful-mermaid so you can sanity-check layout without opening a browser. - Optional SVG Output: Renders the diagram to an SVG file when an output path is provided. - Use Case: Before embedding a flowchart in a project README, draft it as diagram.mmd, run the validation script, fix any reported errors, then copy the verified Mermaid block into your Markdown file. ## Quick Start Ask the agent to validate your Mermaid diagram file, for example: "Validate my diagram.mmd file with the mermaid skill and fix any syntax errors."High-intent search queries and answers about installing and using this skill.
Write the diagram in a standalone .mmd file and run the validate.sh script, which parses and renders it with the official mermaid-cli. Once it validates without errors, copy the Mermaid block into your Markdown file.
The @mermaid-js/mermaid-cli package (mmdc) parses and renders Mermaid files from the command line, exiting nonzero with the parser's error message when syntax is invalid. This Skill's validate.sh script wraps it via npx.
Yes, the validation script requires Node.js and npx to run @mermaid-js/mermaid-cli. The first run also downloads a headless Chromium through Puppeteer, unless PUPPETEER_EXECUTABLE_PATH points to an installed browser.
The ASCII preview uses beautiful-mermaid, which does not support every Mermaid diagram type. An unsupported type prints a warning rather than failing validation, since the official CLI render already confirmed the syntax is valid.
Yes, pass an output path as the second argument to validate.sh and mermaid-cli renders the diagram to that SVG file. Without an output argument, the SVG goes to a temporary file that is deleted after validation.
zhuyingqinGenerates Mermaid diagram source from natural-language requirements and validates it with mmdc.
microsoftPackage wiki Markdown into a VitePress static site with dark theme and Mermaid diagrams.
podcodarFormat and validate Markdown files for consistent headings, lists, and YAML frontmatter.
chengzongcaiGenerate and render Mermaid, Graphviz DOT, PlantUML, and SVG diagrams from natural language or structured inputs.