mermaid-to-image — скилл для Claude Code: что делает и как установить
Скилл mermaid-to-image преобразует Mermaid-диаграммы в Markdown-файлах в PNG через API mermaid.ink и заменяет блоки кода ссылками на изображения.
лицензия не указана 4 000 установок обновлён 2026-08-28
npx skills add zc277584121/marketing-skills --skill mermaid-to-image -a claude-codeЧто делает mermaid-to-image
Скилл находит блоки с кодом Mermaid в указанных файлах, рендерит каждый в PNG через внешний API и подставляет вместо кода ссылку на картинку. Внутри — Python-скрипт, который кодирует диаграмму в base64, отправляет запрос с заголовком User-Agent (без него API вернёт 403) и сохраняет результат в выбранную папку. Пути к изображениям формируются относительно файла или абсолютно — в зависимости от того, как устроен проект.
Пригодится для публикации документации на платформах, где Mermaid не работает из коробки: GitHub Pages с Jekyll, Dev.to, статические сайты. Скилл сам предлагает папку для картинок, если в проекте несколько подходящих (images/, assets/, docs/figures/), и генерирует имена файлов по содержимому диаграммы. Для работы достаточно стандартной библиотеки Python.
Какие задачи решает
- превратить Mermaid-блоки в PNG для публикации на платформе без рендера диаграмм
- заменить код диаграмм в Markdown ссылками на готовые изображения
- подготовить документацию с диаграммами для статического сайта
- сохранить PNG-версии всех схем из файла или папки
Примеры запросов агенту
- Преобразуй Mermaid-блоки в
docs/architecture.mdв картинки - Переведи все диаграммы из папки
docs/в PNG - Замени вторую Mermaid-схему в README на изображение
Как установить mermaid-to-image
1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-image -a claude-code2Вручную: положить файлы
~/.claude/skills/mermaid-to-image/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mermaid-to-image/
1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-image -a codex2Вручную: положить файлы
.agents/skills/mermaid-to-image/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-image -a cursor2Вручную: положить файлы
.cursor/skills/mermaid-to-image/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install zc277584121/marketing-skills skills/mermaid-to-image2Вручную: положить файлы
.github/skills/mermaid-to-image/SKILL.md1Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-image -a gemini-cli2Командой платформы
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/mermaid-to-imageВручную: положить файлы
.devin/skills/mermaid-to-image/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add zc277584121/marketing-skills --skill mermaid-to-image -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mermaid-to-image
Как установить mermaid-to-image в Claude Code?
Запусти npx skills add zc277584121/marketing-skills --skill mermaid-to-image -a claude-code, файл появится в ~/.claude/skills/mermaid-to-image/SKILL.md.
Что делает mermaid-to-image?
Находит Mermaid-блоки в Markdown, рендерит каждый в PNG через API mermaid.ink и заменяет код ссылкой на сохранённое изображение.
Что нужно для работы mermaid-to-image?
Стандартная библиотека Python. API mermaid.ink требует заголовок User-Agent, скрипт подставляет его автоматически.