Mermaid To Image

---
name: mermaid-to-image
description: "Рендер Mermaid-диаграмм (.mmd) в PNG/SVG. Скрипт mermaid_to_image.py читает .mmd (файл или stdin) и отдаёт изображение: приоритет локальному mmdc (mermaid-cli), fallback на публичный API mermaid.ink. Поддерживает выбор формата (svg/png), фоновый цвет, масштаб PNG, движок рендера (auto/mmdc/ink), вывод в файл или stdout. Триггеры: 'mermaid в картинку', 'отрендерить диаграмму', '.mmd в png', 'mermaid to image', 'render diagram', 'диаграмма в svg', 'схема в картинку'."
license: MIT
metadata:
  author: best
  version: 1.0.1
compatibility: "Requires Python 3 stdlib; optional: mermaid-cli (mmdc) для офлайн-рендера"
when_to_use: "Convert a Mermaid .mmd diagram into a PNG/SVG image file for README, docs, or slides. Triggers: 'mermaid to image', 'render diagram', 'mermaid в картинку', 'отрендерить диаграмму', '.mmd в png', 'диаграмма в svg', 'схема в картинку'. Example: 'Turn this mermaid diagram into a PNG for my README.'"
---

# Mermaid To Image

> Рендер Mermaid-диаграмм из текста `.mmd` в файлы PNG/SVG.

Загружай этот скилл когда нужно **превратить Mermaid-диаграмму в картинку**:
для README, документации, презентаций, бейджей или вложений в отчёты.

## 🎯 When to use

Use this skill when:
- Есть `.mmd`-файл или текст Mermaid и нужен PNG/SVG-файл
- Нужно вставить диаграмму в README/вики/презентацию (у рендер-плагинов GitHub нет PNG)
- Просят «отрендерить диаграмму», «mermaid в png», «схему в картинку»
- Нужна статичная картинка для экспорта (не интерактивная mermaid.live)

Do NOT use when:
- Диаграмма нужна только в Markdown-исходнике — GitHub рендерит Mermaid сам
- Нужны диаграммы из текстового описания без Mermaid-кода — это `diagram-maker`
- Нужны диаграммы архитектуры AWS/GCP — отдельный рендер в roadmap

## 📦 Files

- `SKILL.md` — этот файл
- `scripts/mermaid_to_image.py` — рендерер .mmd → PNG/SVG (Python 3 stdlib)

## 🧰 Usage

```bash
# Файл → SVG (по умолчанию):
python3 skills/mermaid-to-image/scripts/mermaid_to_image.py -i diagram.mmd -o diagram.svg

# Файл → PNG:
python3 skills/mermaid-to-image/scripts/mermaid_to_image.py -i diagram.mmd -o diagram.png

# Из stdin (текст прямо в пайплайне):
cat diagram.mmd | python3 mermaid_to_image.py --stdin -o out.svg

# С фоном и масштабом:
python3 mermaid_to_image.py -i d.mmd -o d.png --bg white --scale 3

# В stdout (для программного использования):
python3 mermaid_to_image.py -i d.mmd --stdout > d.svg
```

## 🧭 Движки рендера

| Движок | Как включить | Когда выбирать |
|--------|-------------|----------------|
| `mmdc` (mermaid-cli) | `--engine mmdc` (npm i -g @mermaid-js/mermaid-cli) | офлайн, приватные схемы, большие диаграммы, точный контроль |
| `ink` (mermaid.ink) | `--engine ink` | без установки, быстрый старт; PNG отдаётся как JPEG-образ |

По умолчанию `--engine auto`: используется `mmdc`, если он установлен, иначе `ink`.

## 🔬 Проверка результата

- SVG: файл начинается с `<svg`, валиден для вставки в Markdown/HTML.
- PNG: `file out.png` показывает «JPEG image data» — это нормально для mermaid.ink
  (API отдаёт JPEG-кодированный образ); визуально проверьте открытием.
- При ошибке сети/API скрипт пишет причину в stderr и завершается с кодом 2.

## Boundaries

- Do not use to design a new diagram from prose; use `diagram-maker`.

## Evidence and completion gate

Run the documented command against the user’s actual input. Report the command, exit status, files changed or produced, and relevant stdout/stderr. Separate blocked or pre-existing failures from failures introduced by the current work. Do not call the result complete when the script was only described or when an artifact was not reopened and checked.