Skip to content

Agent skill that turns natural language, code, Terraform/K8s, SQL, OpenAPI, AsyncAPI, Protobuf and GraphQL sources into editable, tested draw.io architecture diagrams: incremental sync, multi-view projection, drift diff, CI architecture tests, whiteboard derasterize, interactive HTML/PPTX/Mermaid exports.

docs: document custom output directory for -o flag (issue #5)

Agents365-ai407fda2286e4
diff --git a/SKILL.md b/SKILL.md
index c19d55a..280c14a 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -442,6 +442,9 @@ draw.io -x -f svg -o diagram.svg input.drawio
# PDF export
draw.io -x -f pdf -o diagram.pdf input.drawio
+
+# Custom output directory (e.g. CI artifacts dir) — create if missing, then export there
+mkdir -p ./artifacts && draw.io -x -f png -e -s 2 -o ./artifacts/diagram.drawio.png input.drawio
```
**Key flags:**
@@ -449,7 +452,7 @@ draw.io -x -f pdf -o diagram.pdf input.drawio
- `-f` — format: `png`, `svg`, `pdf`, `jpg`
- `-e` — embed diagram XML in output (PNG, SVG, PDF only) — exported file remains editable in draw.io
- `-s` — scale: `1`, `2`, `3` (2 recommended for PNG)
-- `-o` — output file path (use `.drawio.png` double extension when embedding)
+- `-o` — output file path; accepts any directory (e.g. `./artifacts/diagram.drawio.png`) — `mkdir -p` the target dir first. Use `.drawio.png` double extension when embedding.
- `-b` — border width around diagram (default: 0, recommend 10)
- `-t` — transparent background (PNG only)
- `--page-index 0` — export specific page (default: all)