К основному содержанию
скилл CX Codex

drawio-skill — скилл для Claude Code: диаграммы и установка

Скилл для Claude Code создаёт и редактирует схемы draw.io в редактируемом формате .drawio. Преобразует код и схемы данных в визуальные модели архитектуры.

MIT 8 100 установок ★ 10 889 обновлён 2026-10-11

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

Что делает drawio-skill

Скилл помогает создавать редактируемые диаграммы по описанию и преобразовывать в них код, Terraform, Kubernetes-конфигурации, SQL и API-схемы. Поддерживает архитектурные схемы, UML, ERD, диаграммы последовательностей, BPMN, сети и swimlane. Для стандартных схем без особого оформления может преобразовать Mermaid в .drawio.

Для работы с диаграммами использует scripts/diagramctl.py: командами можно собирать схемы, обновлять их с сохранением ручной раскладки, создавать несколько представлений, запускать проверки и делать обзор. Есть также запросы к диаграмме, анализ сценариев отказа и экспорт. Для базовых операций нужен Python 3; нативный экспорт требует установленного draw.io, а Graphviz нужен для автоматической раскладки. Без Python 3 основной рабочий процесс не запустится.

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

  • создать редактируемую архитектурную диаграмму по описанию
  • построить схему из Terraform, SQL или OpenAPI
  • обновить сгенерированную диаграмму, сохранив ручную раскладку
  • проверить диаграмму по архитектурным правилам
  • сделать представления системы для разных задач

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

  • Создай редактируемую диаграмму архитектуры сервиса в формате .drawio.
  • Построй диаграмму из Terraform в ./infra и сохрани её как architecture.drawio.
  • Обнови architecture.drawio по ./infra, сохранив ручную раскладку.

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

1Через Skills CLI (Vercel)

npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a claude-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о drawio-skill

Как установить drawio-skill в Claude Code?

Выполните npx skills add Agents365-ai/drawio-skill --skill drawio-skill -a claude-code. Файл скилла находится в ~/.claude/skills/drawio-skill/SKILL.md.

Что делает drawio-skill?

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

Нужен ли установленный draw.io для работы скилла?

Для базовых операций с диаграммами достаточно Python 3. Установленный draw.io нужен для нативного экспорта, а Graphviz — для автоматической раскладки.

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

SKILL.md · MIT
---
disable-model-invocation: true
name: drawio-skill
description: Create and edit draw.io/diagrams.net diagrams as editable `.drawio` files. Covers architecture, UML/ERD/sequence, BPMN, network, and swimlane views authored from a description or converted from code, IaC, SQL, and API schemas, plus sync, query, test, review, export, and publish of existing diagrams. Use when the user asks for draw.io/diagrams.net or an editable diagram; prefer Mermaid/PlantUML when diagrams-as-code is enough.
license: MIT
allowed-tools: [Bash, Read, Write, WebFetch]
metadata: {"openclaw":{"requires":{"anyBins":["python3"]},"emoji":"📐","os":["darwin","linux","win32"],"install":[{"id":"brew-drawio","kind":"brew","formula":"drawio","bins":["drawio"],"label":"Install draw.io for native exports","os":["darwin"],"optional":true},{"id":"brew-graphviz","kind":"brew","formula":"graphviz","bins":["dot"],"label":"Install Graphviz for automatic layout","os":["darwin"],"optional":true}]},"hermes":{"tags":["drawio","diagram","architecture","visualization","uml"],"category":"design","requires_tools":["python3"],"related_skills":["mermaid","excalidraw","plantuml"]},"author":"Agents365-ai","version":"3.4.3","homepage":"https://github.com/Agents365-ai/drawio-skill","compatibility":"Core IR, XML, sync, query, test, review, and Story workflows need Python 3 only; native export needs draw.io; Graphviz is optional.","platforms":["macos","linux","windows"]}
---

# Draw.io Architecture Studio

Produce editable `.drawio` artifacts, not flattened pictures. The preferred
entrypoint is `scripts/diagramctl.py`, which unifies generation, incremental
sync, multi-view projection, semantic queries/tests/reviews, failure analysis,
and accessible publishing over a shared Diagram IR.

## Choose the workflow

| Request | Route |
| --- | --- |
| Natural-language diagram with precise styling | Read `references/diagram-types.md`, then `references/xml-authoring.md` and author XML |
| Standard flowchart/mindmap/gantt/timeline/etc. with no special styling | If draw.io >=30, read `references/mermaid-authoring.md` and convert Mermaid to native `.drawio` |
| Large graph (~15+ nodes) that needs automatic layout | Use `autolayout.py`; read `references/autolayout.md` before passing any `--layout` value |
| Code, Terraform, K8s, compose, SQL, OpenAPI, AsyncAPI, or CI source | Use `diagramctl.py build`; read `references/diagram-ir.md` |
| Protocol Buffers schema (.proto) | Use `protoimports.py` or `diagramctl.py build`; read `references/toolbox.md` |
| GraphQL SDL schema (.graphql/.gql) or introspection JSON | Use `graphqlerd.py` or `diagramctl.py build`; read `references/toolbox.md` |
| Running cluster/stack/cloud (actual state, not declared config) | Read `references/live-infra.md`, then use `tfstate.py`, `dockerimports.py`, or `k8simports.py -` |
| Update a generated diagram without losing manual layout | Use `diagramctl.py sync`; read `references/diagram-ir.md` |
| Executive/system/deployment/data-flow/security views | Use `diagramctl.py views`; read `references/diagram-ir.md` |
| Query, architecture policy, review, what-if, or guided walkthrough | Read `references/semantic-workflows.md` |
| MCP host (Claude Desktop, Cursor, VS Code, Codex) should call these workflows | Register `scripts/diagramctl_mcp.py`; read `references/mcp.md` |
| Prompt phrasing for a diagram type or semantic workflow | Read `references/cookbook.md` |
| Enforce architecture rules or visual diffs in GitHub Actions CI | Read `references/ci-gate.md` |
| Rendered before/after/diff images as a PR review comment | Use `prdiff.py`; read `references/pr-bot.md` |
| Existing `.drawio` to HTML/PPTX/Mermaid/Markdown/animation/runbook | Read `references/toolbox.md`; `diagramctl.py transform` exposes the existing tools |
| Pipeline, journey, or subsystem map drawn as a metro/subway map | Use `tubemap.py`; read `references/tubemap.md` |
| Shape, cloud/vendor, AI, or Databricks icon | Read `references/shapes.md` or `references/databricks.md`; never guess shape names |
| Learn/apply/manage a visual style | Read `references/style-presets.md` |
| Extract a reusable style from an existing diagram or theme | Read `references/style-extraction.md` |
| Existing image to editable diagram (screenshot, whiteboard photo, legacy PNG) | Read `references/derasterize.md` |
| Export/platform problem | Read `references/troubleshooting.md`; for access/network questions read `references/security.md` |

## Unified CLI

Run from this skill directory, or replace `scripts/` with the absolute path to
this skill's scripts directory:

```bash
python3 scripts/diagramctl.py doctor
python3 scripts/diagramctl.py build model.json --from ir -o architecture.drawio
python3 scripts/diagramctl.py build ./infra --from terraform --group \
  --ir-output architecture.ir.json -o architecture.drawio
python3 scripts/diagramctl.py sync architecture.drawio ./infra --from terraform \
  -o architecture.next.drawio
python3 scripts/diagramctl.py views architecture.ir.json \
  --views executive,system,deployment,dataflow,security -o views.drawio
python3 scripts/diagramctl.py test architecture.drawio --rules policy.yml
python3 scripts/diagramctl.py review architecture.drawio -o review.md
python3 scripts/diagramctl.py query architecture.drawio --from internet --to orders-db
python3 scripts/diagramctl.py whatif architecture.ir.json --fail kafka \
  --drawio kafka-failure.drawio -o impact.json
python3 scripts/diagramctl.py story architecture.ir.json -o walkthrough.html
```

`doctor` does not launch GUI tools unless `--probe` is passed. Core semantic
commands are offline and stdlib-only.

## Creation workflow

1. Infer the diagram type, audience, scope, output format, and location from the
   request. Ask only when a missing choice materially changes the result;
   default to PNG plus `.drawio` in the working directory.
2. Select the authoring route from the table above. For a data-backed diagram,
   prefer Diagram IR and preserve provenance. For a large graph, use an importer
   or `autolayout.py`; do not hand-place more than roughly fifteen nodes.
3. Resolve an explicitly named style preset, or the user's default preset, as
   documented in `references/style-presets.md`. Structural diagram conventions
   and visual presets compose; they do not replace each other.
4. Generate the `.drawio`, then run structural validation:

   ```bash
   python3 scripts/validate.py diagram.drawio --score
   ```

   When semantic metadata or an architecture policy is in scope, also run
   `diagramctl.py test`. Do not present inferred semantic findings as verified
   runtime facts.
5. Export a draft PNG without embedded XML and inspect it visually. Fix obvious
   overlap, clipping, disconnected edges, edge-through-node routing, stacked
   edges, and unreadable labels. Stop automatic vision repair after two rounds.
   When the drawio binary is unavailable or a visual check is inconclusive,
   verify the renderer's own DOM instead (`--dump-dom` on the viewer URL, see
   `references/troubleshooting.md`): read each edge's `<path>` segments and
   label anchor coordinates directly — vision alone both misses geometry
   defects and hallucinates new ones.
6. Show the draft and apply targeted edits. Preserve existing geometry for
   local changes. Use `sync` for source-backed changes and write a reviewable
   output; use `--prune` only when deletion was requested.
7. After approval, create final requested formats and report both editable
   source and export paths.

## Export invariants

Resolve the available binary once (`drawio`, `draw.io`, the macOS app path, or
the Windows executable) and use that exact binary for the run.

```bash
# Draft for visual inspection: never use -e here
drawio -x -f png --width 2000 -o diagram.png diagram.drawio

# Final editable PNG
drawio -x -f png -e -s 2 -o diagram.drawio.png diagram.drawio
python3 scripts/repair_png.py diagram.drawio.png

# Final editable SVG/PDF
drawio -x -f svg -e --embed-svg-images -o diagram.svg diagram.drawio
drawio -x -f pdf -e -o diagram.pdf diagram.drawio
```

Do not combine `--width` and `-s`. Embedded PNG exports require
`repair_png.py`; draft PNGs used by vision must not use `-e`. On Linux headless,
follow `references/troubleshooting.md` rather than improvising Electron flags.
If the CLI crashes in a macOS sandbox, try one permitted escalated run, then use
`encode_drawio_url.py` or deliver XML; do not repeatedly launch it.

## Editing and identity

- Use stable semantic IDs and never reuse reserved IDs `0` or `1`.
- Every edge requires `<mxGeometry relative="1" as="geometry"/>`.
- For a local edit, change the matching cell only; for a global direction
  change, regenerate/re-layout the page.
- Keep provenance, `data-model-id`, semantic properties, manual geometry, and
  manual styles intact unless the user requests otherwise.
- When reconciling, retain removals as reviewable faded elements by default.
- For edges stacked at a boundary, run `edgeports.py`; add waypoints when an
  edge still crosses an unrelated shape. There is no CLI-only edge rerouter
  that preserves node positions.

## Quality and trust

An attractive diagram can still be wrong. Prefer source-backed relationships,
show provenance where useful, distinguish exact extraction from AI inference,
and keep architecture review findings framed as prompts. Story HTML must remain
self-contained, keyboard usable, and include a text alternative. Never include
secrets in node properties or provenance because they are embedded in outputs.

For all focused scripts and composition patterns, read `references/toolbox.md`;
load only the task-specific reference needed for the current request.

© Agents365-ai · MIT · Agents365-ai/drawio-skill

Похожие скиллы

Каталог скиллов SKILL.md →
drawio bahayonghang Создаёт и редактирует диаграммы draw.io по YAML-спецификациям. Переводит описания микросервисов и сетевых топологий в схемы без ручной расстановки блоков. CX Codex +1 8 800установок drawio-logical-diagrams giuseppe-trisciuoglio Скилл drawio-logical-diagrams для Claude Code генерирует файлы .drawio в нативном XML-формате для логических схем, архитектуры систем, BPMN и UML. Визуализирует логику без облачных сервисов. CX Codex +1 4 200установок drawio-diagrams stark-ai-de Скилл drawio-diagrams создаёт, редактирует и проверяет файлы .drawio прямо в диалоге с агентом. Он собирает технические схемы и архитектуру, но не строит аналитические графики. CX Codex +1 2 700установок drawio-academic-skills bahayonghang Скилл drawio-academic-skills для draw.io, который готовит рисунки под статью, диссертацию или заявку IEEE/ACM: схемы, workflow, роадмапы и сетевые топологии. CX Codex +1 1 000установок cli-anything-drawio HKUDS Скилл cli-anything-drawio для Claude Code и Cursor: агент создаёт, редактирует и экспортирует диаграммы Draw.io через командную строку. Работает через Python-пакет с выводом в JSON для программного использования. CX Codex +1 744установок drawio-reconstruction HKUSTDial Скилл drawio-reconstruction воссоздаёт схемы, слайды и скриншоты в редактируемый формат .drawio с сохранением исходного стиля. Скилл пригодится, когда растровое изображение нужно превратить в векторный проект Draw.io. CX Codex +1 688установок

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

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