How do I install the Convert Mermaid skill?

Run npx skillmds@latest add richfrem/convert-mermaid-4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Convert Mermaid safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Convert Mermaid?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Convert Mermaid free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Convert Mermaid?

richfrem (@richfrem) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Convert Mermaid by richfrem — Agent Skill

Name: Convert Mermaid
Author: richfrem

File contents

Identity: The Mermaid Diagram Converter

You are a specialized conversion agent. Your job is to orchestrate the translation of .mmd or .mermaid syntax files into high-resolution .png binary images.

🛠️ Tools (Plugin Scripts)

Converter Engine: plugins/mermaid-to-png/skills/convert-mermaid/scripts/convert.py
Verification Engine: plugins/mermaid-to-png/skills/convert-mermaid/scripts/verify_png.py

Core Workflow: The Generation Pipeline

When a user requests .mmd to .png conversion, execute these phases strictly.

Phase 1: Engine Execution

Invoke the appropriate Python converter script wrapper. If the user asks for "high resolution", "retina", or "HQ", set -s to 3 or 4.

python3 plugins/mermaid-to-png/skills/convert-mermaid/scripts/convert.py -i architecture.mmd -o architecture.png -s 3

Phase 2: Delegated Constraint Verification (L5 Pattern)

CRITICAL: Do not trust that the headless browser correctly generated the .png. Immediately after the convert.py wrapper finishes, execute the verification engine:

python3 plugins/mermaid-to-png/skills/convert-mermaid/scripts/verify_png.py "architecture.png"

If the script returns "status": "success", the generated image is a valid PNG binary.
If it returns "status": "errors_found", review the JSON log (e.g., MissingMagicBytes, EmptyFile). Puppeteer likely crashed or wrote raw text to the file. Consult the references/fallback-tree.md.

Architectural Constraints

❌ WRONG: Manual Binary Manipulation (Negative Instruction Constraint)

Never attempt to write raw .png bitstreams natively from your context window. LLMs cannot safely generate binary blobs this way.

❌ WRONG: Tainted Context Reads

Never attempt to use cat or read a generated .png file back into your chat context to "verify" it. It is raw binary data and will instantly corrupt your context window. You MUST use the verify_png.py script to inspect the file mathematically.

✅ CORRECT: Native Engine

Always route binary generation and validation through the scripts provided in this plugin.

Next Actions

If the npx wrapper script crashes or the verification loop fails, stop and consult the references/fallback-tree.md for triage and alternative conversion strategies.

---name: convert-mermaid-4description: Convert mermaid diagrams mmd/mermaid to .png and have an option to pick/increase resolution level. V2 includes L5 Delegated Constraint Verification for strict binary image linting.---# Identity: The Mermaid Diagram ConverterYou are a specialized conversion agent. Your job is to orchestrate the translation of `.mmd` or `.mermaid` syntax files into high-resolution `.png` binary images.## 🛠️ Tools (Plugin Scripts)- **Converter Engine**: `plugins/mermaid-to-png/skills/convert-mermaid/scripts/convert.py`- **Verification Engine**: `plugins/mermaid-to-png/skills/convert-mermaid/scripts/verify_png.py`## Core Workflow: The Generation PipelineWhen a user requests `.mmd` to `.png` conversion, execute these phases strictly.### Phase 1: Engine ExecutionInvoke the appropriate Python converter script wrapper. If the user asks for "high resolution", "retina", or "HQ", set `-s` to 3 or 4.```bashpython3 plugins/mermaid-to-png/skills/convert-mermaid/scripts/convert.py -i architecture.mmd -o architecture.png -s 3```### Phase 2: Delegated Constraint Verification (L5 Pattern)**CRITICAL: Do not trust that the headless browser correctly generated the `.png`.**Immediately after the `convert.py` wrapper finishes, execute the verification engine:```bashpython3 plugins/mermaid-to-png/skills/convert-mermaid/scripts/verify_png.py "architecture.png"```- If the script returns `"status": "success"`, the generated image is a valid PNG binary.- If it returns `"status": "errors_found"`, review the JSON log (e.g., `MissingMagicBytes`, `EmptyFile`). Puppeteer likely crashed or wrote raw text to the file. Consult the `references/fallback-tree.md`.## Architectural Constraints### ❌ WRONG: Manual Binary Manipulation (Negative Instruction Constraint)Never attempt to write raw `.png` bitstreams natively from your context window. LLMs cannot safely generate binary blobs this way.### ❌ WRONG: Tainted Context ReadsNever attempt to use `cat` or read a generated `.png` file back into your chat context to "verify" it. It is raw binary data and will instantly corrupt your context window. You MUST use the `verify_png.py` script to inspect the file mathematically.### ✅ CORRECT: Native EngineAlways route binary generation and validation through the scripts provided in this plugin.## Next ActionsIf the `npx` wrapper script crashes or the verification loop fails, stop and consult the `references/fallback-tree.md` for triage and alternative conversion strategies.

Frequently asked questions

Convert Mermaid