markdown-viewer-skills — скилл для Claude Code: диаграммы в Markdown
Скилл markdown-viewer-skills для Claude Code и Codex выбирает движок для UML, сетевых схем, графиков и инфографики в Markdown. Создаёт схемы для документации.
MIT 202 установок ★ 35 обновлён 2026-10-21
npx skills add podo/design-agent-skills --skill markdown-viewer-skills -a claude-codeЧто делает markdown-viewer-skills
Скилл работает как роутер. Он смотрит на цель запроса (надёжность сервиса, продуктовые метрики, проектирование софта, облачная архитектура, планы и роадмапы, внутренние документы) и подсовывает нужный справочник движка. Внутри PlantUML для UML, BPMN, ArchiMate и схем сетей с безопасностью (с набором иконок), Vega и Vega-Lite, ECharts, шаблоны инфографики и голый HTML/CSS для схем и карточек. Ещё библиотека проверенных примеров, с которых можно начать. Апстрим зовёт скилл documd-visuals — под этим именем его и вызывают после установки.
Фигуры остаются текстом в Markdown, а картинку рисует просмотрщик. В обычном рендерере вы увидите блок кода, поэтому без docu.md-совместимого просмотрщика вся затея не работает.
Экспорт в html, epub, docx или pdf требует Node 18+ и Chrome/Chromium, а CLI npx @markdown-viewer/documd ставится отдельно: установка скилла его не тянет. Слайды и математику пакет не берёт. Mermaid, draw.io и Graphviz помечены как нерекомендуемые, для скетчей есть excalidraw-agents365 и hand-drawn-diagrams.
Какие задачи решает
- нарисовать диаграмму классов UML прямо в README
- показать облачную или сетевую архитектуру текстом
- собрать график продуктовых метрик на Vega-Lite
- сверстать карточку-инфографику на HTML/CSS
- описать BPMN-процесс без экспорта картинки
Примеры запросов агенту
- Нарисуй диаграмму классов UML для модуля оплаты в
ARCHITECTURE.md - Построй график выручки по месяцам на Vega-Lite и вставь в
metrics.md - Сделай схему сети на PlantUML для стенда staging
Как установить markdown-viewer-skills
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill markdown-viewer-skills -a claude-code2Вручную: положить файлы
~/.claude/skills/markdown-viewer-skills/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/markdown-viewer-skills/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill markdown-viewer-skills -a codex2Вручную: положить файлы
.agents/skills/markdown-viewer-skills/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill markdown-viewer-skills -a cursor2Вручную: положить файлы
.cursor/skills/markdown-viewer-skills/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/markdown-viewer-skills2Вручную: положить файлы
.github/skills/markdown-viewer-skills/SKILL.md1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill markdown-viewer-skills -a gemini-cli2Командой платформы
gemini skills install https://github.com/podo/design-agent-skills --path skills/markdown-viewer-skillsВручную: положить файлы
.devin/skills/markdown-viewer-skills/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill markdown-viewer-skills -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о markdown-viewer-skills
Как установить markdown-viewer-skills в Claude Code?
Выполните npx skills add podo/design-agent-skills --skill markdown-viewer-skills -a claude-code. Скилл окажется в ~/.claude/skills/markdown-viewer-skills/SKILL.md.
Что делает markdown-viewer-skills?
Маршрутизирует запрос к нужному движку: PlantUML для UML, BPMN, ArchiMate и схем сетей, Vega, Vega-Lite и ECharts для графиков, HTML/CSS для карточек и макетов. После установки вызывается под именем documd-visuals.
Что нужно, чтобы диаграммы отрисовались?
Docu.md-совместимый просмотрщик Markdown: обычный рендерер покажет исходник как блок кода. Для экспорта в html, epub, docx или pdf дополнительно нужны Node 18+ и Chrome/Chromium, а CLI npx @markdown-viewer/documd ставится отдельно.
Исходный текст
SKILL.md · MIT
--- name: markdown-viewer-skills description: | One routing skill for text-driven visuals in Markdown, from the docu.md pipeline: charts and analytics (Vega-Lite, ECharts), UML, BPMN, ArchiMate and cloud, network and security architecture (PlantUML), infographics, system-architecture layouts and cards in HTML/CSS. Figures are text in the Markdown, rendered live by the viewer. triggers: - "markdown viewer" - "vega chart" - "PlantUML" - "infographic" - "UML diagram" - "cloud architecture diagram" - "network diagram" das: category: data-visualization upstream: "https://github.com/markdown-viewer/skills" upstream_path: "documd-visuals/SKILL.md" version: latest install: false --- # markdown-viewer-skills > Catalogue stub — full package: [markdown-viewer/skills](https://github.com/markdown-viewer/skills) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** Upstream names this skill `documd-visuals`, so it installs next to this pointer (the pointer is not replaced). - Global: `f=~/.agents/skills/documd-visuals/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/documd-visuals/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `documd-visuals`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/markdown-viewer-skills ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add markdown-viewer/skills --skill documd-visuals -g -y ``` **Project:** ```bash npx skills add markdown-viewer/skills --skill documd-visuals -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Heads-up** - **Requires:** A docu.md-compatible Markdown viewer renders the figures live; plain Markdown renderers show them as code blocks; Optional export to html, epub, docx or pdf needs Node 18+ and Chrome/Chromium (npx @markdown-viewer/documd, installed separately) - **License:** CC-BY-4.0 <!-- das:install:end --> ## Invoke after install - Skill name: `documd-visuals` - Trigger phrases: "vega chart", "PlantUML", "infographic", "UML diagram", "cloud architecture diagram", "network diagram" ## What it does Upstream used to ship many separate engine- and domain-named skills (vega, uml, cloud, network, security, archimate, bpmn, mindmap, infographic, architecture, infocard and others). They are now one package, `documd-visuals`, organised by what the reader wants: a router matches the request to a goal domain (service reliability, product metrics, software design, cloud architecture, planning and roadmaps, internal documents and more), goal guides list the scenarios, and engine references cover PlantUML (UML, ArchiMate, BPMN, cloud/network/security architecture with a large icon stencil set), Vega and Vega-Lite, ECharts, Infographic templates, and bare HTML/CSS for architecture diagrams and cards. It ships a library of verified examples to start from. Figures are written as text in the Markdown and drawn live by a docu.md-compatible viewer, so nothing is pre-rendered. Exporting a document to html, epub, docx or pdf is optional and goes through the separate `npx @markdown-viewer/documd` CLI, which this install does not fetch. ## When NOT to use - Slide decks or math notation: the package excludes them - Mermaid, JSON Canvas, draw.io or Graphviz output: the package marks these as not recommended; use `excalidraw-agents365` or `hand-drawn-diagrams` for sketch-style diagrams - Charts rendered as images through a hosted API or as G2/G6 code → use `antvis-chart-skills`
© podo · MIT · podo/design-agent-skills