Agents365-ai/drawio-skill

📦 v1.5.0 — Architecture

• Restructured the repo to live under the [365-skills](https://github.com/Agents365-ai/365-skills) umbrella plugin marketplace
• Split `SKILL.md` into modular `references/` and `scripts/` (reduces context load on the agent)
• Added Claude Code plugin marketplace support — `/plugin install drawio`

📦 v1.5.1 — Compatibility

• Added top-level `version:` field to `SKILL.md` frontmatter for ClawHub compatibility

📦 v1.5.2 — Maintenance

• Version bump to match upstream channels (SkillsMP / ClawHub / 365-skills)
• ---
• Install / update
• ```bash
• /plugin install drawio
• /plugin update drawio
• skills update drawio-skill
• clawhub update drawio-pro-skill
• + 3 more

✨ ✨ Features

• Custom output directory ([#5](https://github.com/Agents365-ai/drawio-skill/issues/5)) — workflow now honors user-specified output paths. Ask for any path like `./artifacts/` or `docs/images/` and the skill will `mkdir -p` the target dir and export there; perfect for CI/CD artifact pipelines.
• ```
• "generate a flowchart of our pipeline and export PNG+SVG to ./artifacts/"
• ```

🐛 🐛 Fixes

• Browser fallback URL encoding ([#4](https://github.com/Agents365-ai/drawio-skill/issues/4)) — the `python3` snippet for generating `diagrams.net#R...` URLs produced outputs that failed with `atob('...'): The string to be decoded is not correctly encoded.`. Two root causes:
• `zlib.compress()` emits a zlib-wrapped stream; diagrams.net expects raw deflate → now uses `zlib.compressobj(..., -zlib.MAX_WBITS)`.
• `base64.urlsafe_b64encode()` produces `-`/`_` which `window.atob()` rejects → now uses standard `base64.b64encode()`.
• Verified by round-trip: `unquote → b64decode → raw inflate` reproduces the original XML. Thanks @Geker for the report and patch.

📝 📚 Docs

• Commands section gained a CI-style example: `mkdir -p ./artifacts && draw.io -x -f png -e -s 2 -o ./artifacts/diagram.drawio.png input.drawio`
• Clarify checklist gained an "Output location" item (only triggers when the user mentions a path — no extra question by default)
• README (both EN/CN) highlights the v1.4 custom output directory feature

📦 🔧 Chores

• Untracked `docs/superpowers/` (already in `.gitignore`)

📦 📦 Install / Upgrade

• ```bash
• clawhub install drawio-skill
• clawhub update drawio-skill
• ```
• Full changelog: https://github.com/Agents365-ai/drawio-skill/compare/v1.3.0...v1.4.0

📦 Style Presets

• Learn your visual style from any `.drawio` file or image — the skill extracts palette, shapes, fonts, and edge style, renders a sample for preview, and saves only after your approval
• 3 built-in presets: `default`, `corporate`, `handdrawn` — ready to use out of the box
• Management operations: list, show, set default, unset default, delete, rename
• Preset file validation: structural checks on every load; graceful fallback during generation if invalid
• Active preset fully replaces built-in color/shape/edge/font conventions for that diagram
• `fillColor=none` structural values are protected from preset override

🐛 Fixes

• Cross-reference direction, name-normalisation order, and dispatch list corrections
• Tightened step 0.5 trigger phrasing (bare `with <name>` no longer activates a preset)
• Duplicate "telling-the-user" block removed

📝 Docs & Site

• Added dedicated Style Presets section to README.md and README_CN.md
• Fixed auto-update interval: 12 h → 24 h (matches SKILL.md)
• Files section now lists `styles/built-in/` and `references/style-extraction.md`
• Updated GitHub Pages site (index.html / zh.html): v1.3.0 badge, Style Presets feature card, Opencode install tab, comparison table row
• Added `docs/superpowers` to `.gitignore`

✨ New

• Auto-update check — on first use per conversation, the skill quietly checks the upstream repo (throttled to once per 12 hours, silent when up-to-date, offline, or not a git install). When a new version exists, the agent surfaces a one-line notice in its reply, so users learn about updates without watching the repo or running git commands.
• Opencode support — Opencode is now a first-class target (6th platform). Native SKILL.md loading via the `skill` tool, and Opencode also reads `~/.claude/skills/` and `.claude/skills/`, so any existing Claude Code install is automatically picked up.
• Bilingual landing page with theme switching (zh / en).
• Preset examples — microservices source added, plus accessibility/SEO polish in the docs site.

📋 Changed

• `check-update.sh` renamed to `update.sh` and moved to the skill root; removed the old `scripts/` folder.
• Multi-Platform table now shows a single OpenClaw / ClawHub row (same ecosystem).
• Removed `.github/workflows/publish-clawhub.yml` — releases are now published directly with the local `clawhub publish` command.
• `metadata.version` field synced to `1.2.0`.
• Added `.gitignore` for `.DS_Store`, `.playwright-mcp/`, `logs/`.

🐛 Fixed

• Docs, scripts, CI, and metadata issues flagged in earlier Codex review.

📦 Install / Update

• ```bash
• git clone https://github.com/Agents365-ai/drawio-skill.git ~/.claude/skills/drawio-skill
• git clone https://github.com/Agents365-ai/drawio-skill.git ~/.config/opencode/skills/drawio-skill
• clawhub install drawio-pro-skill
• cd <your-install-path>/drawio-skill && git pull
• ```
• Full changelog: https://github.com/Agents365-ai/drawio-skill/compare/v1.1.1...v1.2.0

📦 GitHub Pages Landing Page

• Dark-themed, conversion-focused single-page site at `docs/index.html`
• Hero with install command + copy button
• 6 feature cards, demo gallery, comparison table, tabbed install instructions
• Deploy via GitHub Pages from `docs/` folder

🐛 ClawHub Security Flag Fixes

• Self-check clarity: explicitly states it uses the agent's built-in vision capability (e.g., Claude's image input), and gracefully skips if the model doesn't support vision
• Browser fallback clarity: documents that the diagrams.net URL is fully client-side — diagram XML is encoded in the URL fragment (`#`), never sent to any server
• Source metadata: added `homepage` field to SKILL.md frontmatter, resolving "Source: unknown" in ClawHub registry

📋 Full Changelog

• https://github.com/Agents365-ai/drawio-skill/compare/v1.1.0...v1.1.1

📦 Diagram Type Presets

• 6 built-in presets with recommended shapes, styles, and layout conventions:
• ERD — table containers, PK/FK notation, ER arrows
• UML Class — 3-section swimlanes, inheritance/composition/aggregation arrows
• Sequence — lifelines, sync/async messages, activation boxes
• Architecture — tier-based swimlanes, hub-center strategy
• ML / Deep Learning — layer-type color coding, tensor shape annotations `(B, C, H, W)`, encoder/decoder swimlanes
• Flowchart — semantic shapes (parallelogram I/O, diamond decisions, oval start/end)

📦 Animated Connectors

• Add `flowAnimation=1` to any edge style for moving dot animation — ideal for data-flow and pipeline diagrams. Works in SVG export and draw.io desktop.

📦 ML Model Diagram Support

• Purpose-built for academic papers (NeurIPS, ICML, ICLR):
• Layer-type color coding (blue=Conv, purple=Attention, yellow=RNN, orange=FC)
• Tensor shape annotations on each layer via multi-line labels
• Skip connections with dashed curved arrows
• Encoder/decoder grouping via swimlanes

📦 Grid-Aligned Layout

• All coordinates snap to 10px multiples — produces cleaner diagrams and makes manual editing in draw.io easier.

📦 Multi-line Text

• Use `&#xa;` for line breaks in `value` attributes (not literal `\n`).

📦 Browser Fallback

• When draw.io desktop CLI is unavailable, generates a `diagrams.net` URL that opens the diagram in-browser for viewing and editing.

📦 Auto-Launch Desktop App

• After export, offers to open the `.drawio` file in draw.io desktop for fine-tuning.

📋 Full Changelog

• https://github.com/Agents365-ai/drawio-skill/compare/v1.0.0...v1.1.0