mdv-markdown-visualization — скилл для Claude Code
Скилл учит агента писать файлы .mdv — расширение Markdown с графиками, KPI-карточками и выгрузкой в HTML или PDF.
npx skills add reason-machines/trending-skills --skill mdv-markdown-visualization -a claude-codeЧто делает mdv-markdown-visualization
MDV — надмножество CommonMark для файлов .mdv. Кроме обычного текста в них есть YAML-шапка с темой и ссылками на данные, блоки визуализации в тройных кавычках и контейнеры ::: для вёрстки. Из одного файла получается отчёт, дашборд или колода слайдов.
Внутри блока stat задаётся строка KPI-карточек: метка, значение и необязательная дельта. Блок chart принимает тип (bar, line, area, pie, donut, scatter), имя набора данных из шапки или CSV прямо в теле блока, колонки для осей, разбивку по сериям и формат значений вроде currency. Контейнер toc собирает оглавление по заголовкам, callout даёт цветные врезки, columns раскладывает графики в две колонки. Темы: report, dashboard, slides, minimal.
Рендер идёт через CLI: render собирает самодостаточный HTML, preview открывает браузер и перезагружает страницу при сохранении, export --pdf отдаёт PDF. В примерах команды вызываются как node packages/mdv-cli/dist/index.js, то есть сборка лежит локально. Скилл ставится в шесть платформ, но пути к файлу скилла у каждой свои.
Какие задачи решает
- собрать квартальный отчёт с графиками в одном файле
- показать метрики сервиса карточками с дельтой
- выгрузить документ в PDF без вёрстки вручную
- разложить два графика рядом в две колонки
- вставить предупреждение или важную врезку в текст
Примеры запросов агенту
- Сделай файл
.mdvс темойdashboardи карточками по метрикам изdata/ops.csv - Добавь в отчёт график
chart type=lineпо месяцам с разбивкой по регионам - Собери оглавление через
::: tocи выгрузи документ в PDF
Как установить mdv-markdown-visualization
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mdv-markdown-visualization -a claude-code2Вручную: положить файлы
~/.claude/skills/mdv-markdown-visualization/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mdv-markdown-visualization/
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mdv-markdown-visualization -a codex2Вручную: положить файлы
.agents/skills/mdv-markdown-visualization/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mdv-markdown-visualization -a cursor2Вручную: положить файлы
.cursor/skills/mdv-markdown-visualization/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills mdv-markdown-visualization2Вручную: положить файлы
.github/skills/mdv-markdown-visualization/SKILL.md1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mdv-markdown-visualization -a gemini-cli2Командой платформы
gemini skills install https://github.com/reason-machines/trending-skills --path skills/mdv-markdown-visualizationВручную: положить файлы
.devin/skills/mdv-markdown-visualization/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill mdv-markdown-visualization -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mdv-markdown-visualization
Как установить mdv-markdown-visualization в Claude Code?
Выполните npx skills add reason-machines/trending-skills --skill mdv-markdown-visualization -a claude-code. Скилл окажется в ~/.claude/skills/mdv-markdown-visualization/SKILL.md.
Что делает mdv-markdown-visualization?
Учит агента писать документы в формате MDV: графики, KPI-карточки, врезки и колонки прямо в Markdown, с выгрузкой в HTML или PDF.
Какие типы графиков поддерживает MDV?
bar, line, area, pie, donut и scatter. Данные берутся из набора, объявленного в YAML-шапке, либо из CSV внутри блока.
