К основному содержанию
скилл GitHub Copilot официальный · GitHub

drawio — скилл для GitHub Copilot: что делает и как установить

Создаёт схемы draw.io в виде файлов .drawio и экспортирует их в PNG, SVG или PDF со встроенным XML.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add github/awesome-copilot --skill drawio -a claude-code
Открыть на GitHub

Что делает drawio

Скилл генерирует структуру диаграмм в формате XML mxGraphModel и записывает её в файл .drawio. Готовую разметку он переводит в растровые или векторные изображения через вспомогательный скрипт drawio-to-png.mjs.

Для экспорта скрипт обращается к установленному десктопному draw.io CLI. Если программы нет в системе, запускается рендеринг через Chromium с библиотекой puppeteer-core. Перед первым экспортом требуется выполнить npm install в каталоге scripts. Форматы PNG, SVG и PDF сохраняют XML внутри файла, поэтому готовую картинку можно снова открыть в редакторе draw.io.

Ставьте скилл, если нужно оформлять архитектурные диаграммы для документации и отчётов прямо из чата с ассистентом.

Какие задачи решает

  • создать файл .drawio с разметкой mxGraphModel по текстовому описанию
  • экспортировать схему в PNG для вставки в документы
  • сохранить диаграмму в SVG или PDF со встроенным редактируемым XML
  • пакетно преобразовать каталог файлов .drawio в изображения

Примеры запросов агенту

  • Создай схему архитектуры сервиса в auth-flow.drawio и экспортируй в PNG
  • Сделай диаграмму базы данных с таблицами и связями в формате .drawio
  • Экспортируй все файлы .drawio из папки docs в картинки

Как установить drawio

1Через Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill drawio -a claude-code

2Вручную: положить файлы

~/.claude/skills/drawio/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/drawio/

Похожие

skill-creator официальный anthropics Помогает создать новый скилл, доработать существующий и проверить результат через тестовые промпты и оценки. Claude Code Claude.ai 414 180установок grill-with-docs Matt Pocock Скилл проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. Claude Code 1 219 756установок setup-matt-pocock-skills Matt Pocock Настраивает репозиторий для инженерных скиллов Matt Pocock: трекер задач, метки triage и правила доменной документации. Запускайте перед первым использованием набора. Claude Code 1 052 851установок handoff Matt Pocock Собирает текущий диалог в документ передачи, чтобы другой агент продолжил работу с нужным контекстом. Нужен при смене сессии или исполнителя. Claude Code 1 038 491установок triage Matt Pocock Скилл проводит issue и внешние PR через роли триажа, проверку и подготовку брифа для агента. Подойдёт мейнтейнеру, который разбирает очередь задач. Claude Code 990 453установок domain-modeling Matt Pocock Скилл помогает уточнять термины проекта, вести GLOSSARY.md и фиксировать архитектурные решения в ADR. Нужен, когда модель предметной области меняется. Claude Code 876 391установок

Вопросы о drawio

Как установить drawio в GitHub Copilot?

Выполните npx skills add github/awesome-copilot --skill drawio или gh skill install github/awesome-copilot drawio. Также файл SKILL.md можно вручную скопировать в .github/skills/drawio/.

Что делает скилл drawio?

Он формирует файлы .drawio и конвертирует их в PNG, SVG или PDF. В экспортированные файлы вшивается исходный XML, поэтому схему можно в любой момент открыть и отредактировать в draw.io.

Что нужно для работы экспорта изображений?

Понадобится Node.js и установка зависимостей командой npm install в папке skills/drawio/scripts. Для самого рендеринга подходит либо установленный десктопный draw.io, либо браузер на базе Chromium через puppeteer-core.

Исходный текст

SKILL.md · MIT
---
name: drawio
description: Generate draw.io diagrams as .drawio files and export to PNG/SVG/PDF with embedded XML
---

# Draw.io Diagram Skill

Generate draw.io diagrams as native `.drawio` files and export them to PNG images that can be embedded in Word documents.

## How to Create a Diagram

1. **Generate draw.io XML** in `mxGraphModel` format for the requested diagram
2. **Write the XML** to a `.drawio` file using the create/edit file tool
3. **Export to PNG** using the bundled export script

## Bundled Export Script

This skill includes `drawio-to-png.mjs`, a Node.js export script with two rendering backends:

1. **draw.io CLI** (pixel-perfect, fastest) — used automatically if draw.io desktop is installed
2. **Official draw.io viewer in headless browser** (pixel-perfect, needs Chromium/Edge) — fallback when CLI is unavailable

### Usage

```bash
# Install dependencies (one-time, from the scripts folder)
cd skills/drawio/scripts && npm install

# Export a single diagram
node skills/drawio/scripts/drawio-to-png.mjs <input.drawio> [output.png]

# Export all .drawio files in a directory
node skills/drawio/scripts/drawio-to-png.mjs --dir <directory>

# Force a specific renderer
node skills/drawio/scripts/drawio-to-png.mjs --renderer=cli|viewer|auto <input.drawio>
```

### Skill Folder Contents

| File | Purpose |
|------|---------|
| `SKILL.md` | This instruction file |
| `scripts/drawio-to-png.mjs` | Node.js export script (CLI + browser fallback) |
| `scripts/package.json` | Dependencies (`puppeteer-core`) |

## Supported Export Formats

| Format | Embed XML | Notes |
|--------|-----------|-------|
| `png` | Yes | Viewable everywhere, editable in draw.io |
| `svg` | Yes | Scalable, editable in draw.io |
| `pdf` | Yes | Printable, editable in draw.io |

## Draw.io XML Style Conventions

Use these styles for consistent, professional diagrams:

```xml
<!-- Primary service (highlighted) -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;strokeWidth=2;arcSize=12;shadow=1;" />

<!-- External system -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;" />

<!-- Success/processing stage -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" />

<!-- Warning/quality gate -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" />

<!-- Error/failure path -->
<mxCell style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;" />

<!-- Data store (cylinder) -->
<mxCell style="shape=cylinder3;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;" />

<!-- Arrow -->
<mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=1;strokeColor=#6c8ebf;strokeWidth=2;" />
```

## Locating the draw.io CLI

Try `drawio` first (works if on PATH), then fall back:

- **Windows**: `"C:\Program Files\draw.io\draw.io.exe"`
- **macOS**: `/Applications/draw.io.app/Contents/MacOS/draw.io`
- **Linux**: `drawio` (via snap/apt/flatpak)

### CLI Export Command

```bash
drawio -x -f png -e -b 10 -o <output.png> <input.drawio>
```

Flags: `-x` (export), `-f` (format), `-e` (embed diagram XML), `-b` (border), `-o` (output path).

© github · MIT · github/awesome-copilot

Смотрите также

Спонсоры проекта

Компании, которые помогают держать аналитику открытой