diagram-design/commands/import-drawio.md at main

jb/diagram-design

Fork 0

Files

T

b827385a17 feat: consolidate reviewed Diagram Design 2.6.0 release (#134 )

* fix(commands): stop hardcoding the visual-type count

Integrates the final reviewed diff from PR #112.

* docs(high-level): correct effective width checklist

Integrates the final reviewed diff from PR #105.

* fix(commands): quote profile argument hint

Integrates the final reviewed diff from PR #126.

* test(sankey): gate conservation and ribbon geometry

Integrates the final reviewed diff from PR #103.

* feat(tooling): add doctor diagnostics gate

Integrates the final reviewed diff from PR #132.

* feat(scripts): lint diagrams as rendered

Integrates the final reviewed diff from PR #18.

* feat(types): add quantitative polar chart

Integrates the final reviewed diff from PR #101.

* chore(release): consolidate reviewed changes in 2.6.0

Documents every combined gate and synchronizes Claude, Codex, and Factory metadata for the 39-type release.

* fix(doctor): support installed-skill projects

---------

Co-authored-by: mysoniw <soniw1@gmail.com>
Co-authored-by: thang <76550342+thangldw@users.noreply.github.com>
Co-authored-by: YinShaokun <yinshaokun@didiglobal.com>
Co-authored-by: 0xDarkMatter <0xDarkMatter@users.noreply.github.com>
Co-authored-by: Rupam Pal <rupam.pal@euromonitor.com>
Co-authored-by: Yuvraj3905 <yuvraj202001@gmail.com>

2026-08-20 12:21:43 -07:00

3.4 KiB

Raw Permalink Blame History

description, argument-hint, allowed-tools

description

argument-hint

allowed-tools

Redraw a draw.io file as an editorial diagram at a chosen format, size, and detail level

Read

Write

Edit

Bash

Glob

Redraw the draw.io file at $1 as a diagram in this skill's design system, following skills/diagram-design/references/import-drawio.md and skills/diagram-design/references/output-spec.md. Treat those references as the source of truth — don't reimplement the logic here.

Full argument string: $ARGUMENTS

Accepts .drawio, .drawio.xml, .xml, .drawio.png, and .drawio.svg.

Defaults

--format=html — a self-contained HTML file next to the source.
--size=doc-inline — viewBox 0 0 960 600.
--detail=balanced · --audience=mixed.
--variant=light — the minimal light template.
A single-page file selects its only page; a multi-page file lists pages and asks which to use.
Type is chosen from the extracted structure; --type forces one of the visual types in SKILL.md §3.

Flags

--format — html (default), svg, png, or html+png. Non-HTML formats are produced from the HTML via references/export.md, never hand-authored.
--size — any preset in output-spec.md §2: doc-inline, doc-wide, slide-16x9, slide-4x3, social-og, social-square, print-a4-landscape, print-letter-landscape, fit.
--detail — faithful (≤24 nodes, zoned), balanced (≤12), simplified (≤7).
--audience — engineer, mixed, executive. Governs wording, not element count.
--type — force a diagram type instead of inferring it.
--page — page index, page name, or all (one file per page).
--variant — light, dark, or full editorial template.
--output — output base path; the extension is appended per format.

Required behaviour

No file provided → ask which .drawio file. Don't guess.
Always locate the installed skill and run <skill-dir>/scripts/drawio_extract.py first. Never assume the skill is under the current working directory, and never read a .drawio file directly — most are compressed, and the raw XML is noise.
Extractor exits non-zero → report its message verbatim and stop.
Digest shows 0 nodes → the source is image-only or encrypted. Say so; ask for the original file. Don't invent content.
Multi-page file with no --page → list the pages with their node/edge counts and ask which one.
Requested detail level is impossible at the requested size (e.g. faithful on a 40-node source at slide-16x9) → say so before drawing and propose overview + per-zone detail.
--detail=faithful above 9 nodes → zone the layout; above 24 nodes, split into overview + detail files.
Never carry over source coordinates, colors, or fonts. The output is a redraw in the project's style-guide.md skin.
Run the SKILL.md §9 taste gate and the output-spec.md §6 checklist before writing.

After writing the files, report the paths, sizes, the four dials used, and the fidelity ledger (what was merged, collapsed, or dropped).

3.4 KiB Raw Permalink Blame History

Defaults

Flags

Required behaviour

3.4 KiB

Raw Permalink Blame History