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.
Python agent-skillsarchitecturearchitecture-diagramasyncapibpmnc4-modelclaude-codediagramdiagrams-as-codedrawioflowchartgithub-actionsgraphqlimage-to-diagramkubernetesmcp-serverprotobufsysmlterraformuml
docs(routing): sync SKILL.md routing table with references/ + toolbox edgeports + v3.2.2
Agents365-aibd1bfe264e6c
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 41d4ae2..6a7fd38 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -5,7 +5,25 @@ on [Keep a Changelog](https://keepachangelog.com/), and the project followssemantic-ish versioning (the `metadata.version` field in`skills/drawio-skill/SKILL.md`).-## [Unreleased]+## [3.2.2] - 2026-09-11++### Fixed++- **drawiodiff.py**: `NameError` when an edge re-points its source node+ (reported in #115, merged in #116).++### Added++- **SKILL.md routing table**: rows for the five reference files previously+ only reachable transitively, so the table again covers every file in+ `references/`: large-graph automatic layout (`autolayout.md`), live+ infrastructure vs declared config (`live-infra.md`), PR-comment rendering+ (`pr-bot.md`), style extraction from an existing diagram+ (`style-extraction.md`), and metro/subway maps (`tubemap.md`).+- **toolbox.md**: entry for `edgeports.py` (boundary port assignment for+ stacked edges on swimlanes), making the "39 focused tools" claim true.+- **LICENSE**: the MIT license text is now also shipped inside+ `skills/drawio-skill/`, so an installed copy of the skill carries it.### Changeddiff --git a/skills/drawio-skill/LICENSE b/skills/drawio-skill/LICENSEnew file mode 100644index 0000000..ec170ad--- /dev/null+++ b/skills/drawio-skill/LICENSE@@ -0,0 +1,21 @@+MIT License++Copyright (c) 2026 Agents365-ai++Permission is hereby granted, free of charge, to any person obtaining a copy+of this software and associated documentation files (the "Software"), to deal+in the Software without restriction, including without limitation the rights+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell+copies of the Software, and to permit persons to whom the Software is+furnished to do so, subject to the following conditions:++The above copyright notice and this permission notice shall be included in all+copies or substantial portions of the Software.++THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE+SOFTWARE.diff --git a/skills/drawio-skill/SKILL.md b/skills/drawio-skill/SKILL.mdindex d95332d..0013a75 100644--- a/skills/drawio-skill/SKILL.md+++ b/skills/drawio-skill/SKILL.md@@ -3,7 +3,7 @@ name: drawio-skilldescription: Create, edit, synchronize, inspect, test, and publish editable draw.io diagrams. Use when the user explicitly requests draw.io/diagrams.net, needs a polished architecture, ERD, UML, sequence, C4, SysML, BPMN, network, swimlane, ML, or infrastructure diagram, wants code/IaC/SQL/OpenAPI converted into a diagram, or wants an existing diagram queried, reviewed, diffed, restyled, kept in sync, or made interactive. Prefer Mermaid/PlantUML elsewhere when the requested artifact is diagrams-as-code rather than an editable draw.io file.license: MITallowed-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.2.1","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"]}+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.2.2","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@@ -19,16 +19,21 @@ and accessible publishing over a shared Diagram IR.| --- | --- || 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, or CI source | Use `diagramctl.py build`; read `references/diagram-ir.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` |diff --git a/skills/drawio-skill/references/toolbox.md b/skills/drawio-skill/references/toolbox.mdindex ca8b807..7396f8b 100644--- a/skills/drawio-skill/references/toolbox.md+++ b/skills/drawio-skill/references/toolbox.md@@ -121,6 +121,7 @@ The skill runs both directions — these turn a `.drawio` back into something el- **`relabel.py`** — swap every label via a JSON map, layout untouched — `--extract` dumps an identity map of all labels (vertices, edges, UserObjects, page names), translate the values, `--map` applies them. Built for bilingual (EN/CN) variants of one diagram.- **`restyle.py`** — apply a style preset (user or built-in, e.g. `dark`) to an existing `.drawio`: palette remap by hue, font, dark-theme extras, page background. Layout, shapes, and edge routing stay put.+- **`edgeports.py`** — pin `exitX/exitY`/`entryX/entryY` ports when several edges stack at the same side of one node (typical on swimlane handoffs); spreads each (node, side) group evenly, keeps already-pinned and hand-tuned geometry, idempotent. Port assignment, not routing; node positions untouched. `SKILL.md` "Editing and identity" says when to reach for it.- **`validate.py`** — deterministic structural lint (dangling edges, dup/reserved ids, overlaps; `--score` for layout readability). Findings render as `error: [E-DANGLING-END] ... (fix: ...)` — stable codes + fix hints; `--json` for structured output. Run before exporting.- **`repair_png.py`** — fix draw.io's truncated IEND chunk after every `-e` PNG export (issue #8).- **`encode_drawio_url.py`** — encode a `.drawio` into a diagrams.net browser URL when the CLI is unavailable (`--edit` for an editable editor URL).