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: correct skill installation layout and update commands (#139)

Agents365.ai57270820d3cd
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 727cc12..4003acc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -30,6 +30,13 @@ semantic-ish versioning (the `metadata.version` field in
`ValueError` listing the unrecognized ids and the valid rules instead of
silently skipping the check; `diagramctl test` reports it on stderr and
exits 2. `review()` and all eight existing rule ids are unchanged.
+- **Installation docs: corrected manual placement and update attribution**:
+ the manual recipes now clone the repository once and link or copy the
+ `skills/drawio-skill/` subdirectory into the host skills root, so `SKILL.md`
+ sits directly under the host entry. The recommended update command is
+ attributed to the skills CLI (`npx skills update drawio-skill -g`), and
+ SkillsMP is described as a listing only. The website install tabs carry the
+ same corrections.
## [3.4.0] - 2026-09-14
diff --git a/README.md b/README.md
index 2996d9d..8624dfd 100644
--- a/README.md
+++ b/README.md
@@ -76,25 +76,26 @@ Verify with `drawio --version`. **Version ≥ 30 recommended** — it unlocks Me
npx skills add Agents365-ai/drawio-skill -g
```
-```bash
-# Manual install
-git clone https://github.com/Agents365-ai/drawio-skill.git \
- ~/.claude/skills/drawio-skill
-
-# Autohand Code global install
-git clone https://github.com/Agents365-ai/drawio-skill.git \
- ~/.autohand/skills/drawio-skill
+Manual install: clone once to a persistent path, then link the skill subdirectory (Claude Code shown). Use `cp -R` instead of `ln -s` on hosts that do not follow symlinks. The destination must not exist yet, so move an existing `drawio-skill` entry aside first.
-# Autohand Code project-level install
-git clone https://github.com/Agents365-ai/drawio-skill.git \
- .autohand/skills/drawio-skill
+```bash
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+mkdir -p ~/.claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
+
+# Copy alternative, for hosts that do not follow symlinks
+# mkdir -p ~/.claude/skills
+# cp -R ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
```
-Autohand Code also supports `autohand --skill-install` for cataloged skills, with `--project` for workspace-level installs. Until this skill is listed there, use the direct clone path above.
+The skill is the `skills/drawio-skill/` subdirectory, so `SKILL.md` must sit directly under the host entry: `<skills root>/drawio-skill/SKILL.md`. Do not clone the repository root into a skills directory. Other host roots (Opencode, OpenClaw, Codex, Autohand Code global and project): [docs/INSTALL_SKILL.md](docs/INSTALL_SKILL.md).
+
+Autohand Code also supports `autohand --skill-install` for cataloged skills, with `--project` for workspace-level installs. Until this skill is listed there, use the manual recipe above with the Autohand Code skills root: `~/.autohand/skills/` (global) or `<project>/.autohand/skills/` (project).
Also indexed on [SkillsMP](https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md).
-**Updating:** `skills update drawio-skill` (SkillsMP) or `git pull` for manual installs. See [docs/INSTALL_SKILL.md#updates](docs/INSTALL_SKILL.md#updates). Release history in [CHANGELOG.md](CHANGELOG.md).
+**Updating:** `npx skills update drawio-skill -g` (skills CLI) for installer installs; link installs update with `git -C ~/src/drawio-skill pull`, and copy installs need a manual refresh. See [docs/INSTALL_SKILL.md#updates](docs/INSTALL_SKILL.md#updates). Release history in [CHANGELOG.md](CHANGELOG.md).
## ⚡ Quick Start
diff --git a/README_CN.md b/README_CN.md
index eaec768..74dfb76 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -76,25 +76,26 @@
npx skills add Agents365-ai/drawio-skill -g
```
-```bash
-# 手动安装
-git clone https://github.com/Agents365-ai/drawio-skill.git \
- ~/.claude/skills/drawio-skill
-
-# Autohand Code 全局安装
-git clone https://github.com/Agents365-ai/drawio-skill.git \
- ~/.autohand/skills/drawio-skill
+手动安装:先克隆到一个固定路径,再把 skill 子目录链接进宿主 skills 根目录(以 Claude Code 为例)。宿主不支持符号链接时改用 `cp -R`。目标路径必须尚未存在;如果已经装有 `drawio-skill`,请先移走旧条目。
-# Autohand Code 项目级安装
-git clone https://github.com/Agents365-ai/drawio-skill.git \
- .autohand/skills/drawio-skill
+```bash
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+mkdir -p ~/.claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
+
+# Copy alternative, for hosts that do not follow symlinks
+# mkdir -p ~/.claude/skills
+# cp -R ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
```
-Autohand Code 也支持通过 `autohand --skill-install` 安装已收录在 Autohand catalog 中的 skill,并可通过 `--project` 安装到当前项目。在该 skill 收录前,请使用上面的直接克隆方式。
+Skill 位于仓库的 `skills/drawio-skill/` 子目录,宿主条目必须让 `SKILL.md` 直接可见:`<skills root>/drawio-skill/SKILL.md`。不要把仓库根目录克隆进 skills 目录。其他宿主路径(Opencode、OpenClaw、Codex、Autohand Code 全局与项目级)见 [docs/INSTALL_SKILL_CN.md](docs/INSTALL_SKILL_CN.md)。
+
+Autohand Code 也支持通过 `autohand --skill-install` 安装已收录在 Autohand catalog 中的 skill,并可通过 `--project` 安装到当前项目。在该 skill 收录前,请按上面的手动安装方式,把 `skills/drawio-skill` 链接到 `~/.autohand/skills/`(全局)或 `<project>/.autohand/skills/`(项目级)。
同时索引于 [SkillsMP](https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md)。
-**更新:** `skills update drawio-skill`(SkillsMP)或 `git pull`(手动安装)。详见 [docs/INSTALL_SKILL_CN.md#更新](docs/INSTALL_SKILL_CN.md#更新)。版本历史见 [CHANGELOG.md](CHANGELOG.md)。
+**更新:** 安装器安装的用 `npx skills update drawio-skill -g`(skills CLI)更新;链接安装用 `git -C ~/src/drawio-skill pull` 更新,复制安装需要手动刷新。详见 [docs/INSTALL_SKILL_CN.md#更新](docs/INSTALL_SKILL_CN.md#更新)。版本历史见 [CHANGELOG.md](CHANGELOG.md)。
## ⚡ 快速开始
diff --git a/docs/INSTALL_SKILL.md b/docs/INSTALL_SKILL.md
index 72f515d..d2c413a 100644
--- a/docs/INSTALL_SKILL.md
+++ b/docs/INSTALL_SKILL.md
@@ -7,29 +7,43 @@
npx skills add Agents365-ai/drawio-skill -g
```
-Manual install — clone into your agent's skills directory:
+Manual install: clone once to a persistent path, then link the skill subdirectory into the host skills root. Use `cp -R` instead of `ln -s` on hosts that do not follow symlinks.
```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 ~/.autohand/skills/drawio-skill
-git clone https://github.com/Agents365-ai/drawio-skill.git .autohand/skills/drawio-skill
+# Clone once to a persistent path (use a location that does not exist yet,
+# or reuse an existing clone of this repository)
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# Link the skill subdirectory into the host skills root (Claude Code shown).
+# The destination must not exist yet: plain ln -s nests inside an existing directory.
+mkdir -p ~/.claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
+
+# Copy instead, for hosts that do not follow symlinks
+# mkdir -p ~/.claude/skills
+# cp -R ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
```
-Common paths: `~/.claude/skills/` (Claude Code), `~/.config/opencode/skills/` (Opencode), `~/.openclaw/skills/` (OpenClaw), `~/.agents/skills/` (Codex), `~/.autohand/skills/` (Autohand Code global), and `<project>/.autohand/skills/` (Autohand Code project). Also indexed on [SkillsMP](https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md).
+The host entry must expose the skill as `<skills root>/drawio-skill/SKILL.md`. Do not clone the repository root into a skills directory. The nested root does not match the documented one-level layout, and recursive discovery varies by host. If `drawio-skill` is already installed, move the old entry aside before you create the new entry, or reuse the source clone at a stable location. If an earlier install cloned the repository root into the skills directory, reuse it as the clone, or move it aside.
-Autohand Code supports `autohand --skill-install` for cataloged skills, with `--project` for workspace-level installs. Until this skill is listed there, use the direct clone path above.
+Common paths: `~/.claude/skills/` (Claude Code), `.claude/skills/` (Claude Code project), `~/.config/opencode/skills/` (Opencode), `~/.openclaw/skills/` (OpenClaw), `~/.agents/skills/` (Codex), `~/.autohand/skills/` (Autohand Code global), and `<project>/.autohand/skills/` (Autohand Code project). Also indexed on [SkillsMP](https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md).
+
+Autohand Code supports `autohand --skill-install` for cataloged skills, with `--project` for workspace-level installs. Until this skill is listed there, use the manual recipe above, linking `skills/drawio-skill` into `~/.autohand/skills/` (global) or `<project>/.autohand/skills/` (project).
## Updates
-Updates flow through whatever channel you installed from:
+The recommended installer owns its own update command. SkillsMP is a listing only: it does not install or update skills.
```bash
-# SkillsMP
-skills update drawio-skill
+# Global install made with the skills CLI
+npx skills update drawio-skill -g
```
-For direct `git clone` installs, pull from your install directory:
+A link install follows the clone. Update the clone to update the skill:
```bash
-cd <your-install-path>/drawio-skill && git pull
+git -C ~/src/drawio-skill pull
```
+
+A copy install does not follow the clone. Update the clone, then copy `skills/drawio-skill/` again into an empty destination. Move the old copy aside first: copying into an existing `drawio-skill` directory nests a second copy inside it.
diff --git a/docs/INSTALL_SKILL_CN.md b/docs/INSTALL_SKILL_CN.md
index 3d6136a..ac3c6ab 100644
--- a/docs/INSTALL_SKILL_CN.md
+++ b/docs/INSTALL_SKILL_CN.md
@@ -7,29 +7,43 @@
npx skills add Agents365-ai/drawio-skill -g
```
-手动安装 —— 克隆到你的 Agent skills 目录:
+手动安装:先克隆到一个固定路径,再把 skill 子目录链接进宿主 skills 根目录。宿主不支持符号链接时改用 `cp -R`。
```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 ~/.autohand/skills/drawio-skill
-git clone https://github.com/Agents365-ai/drawio-skill.git .autohand/skills/drawio-skill
+# Clone once to a persistent path (use a location that does not exist yet,
+# or reuse an existing clone of this repository)
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# Link the skill subdirectory into the host skills root (Claude Code shown).
+# The destination must not exist yet: plain ln -s nests inside an existing directory.
+mkdir -p ~/.claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
+
+# Copy instead, for hosts that do not follow symlinks
+# mkdir -p ~/.claude/skills
+# cp -R ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
```
-常用路径:`~/.claude/skills/`(Claude Code)、`~/.config/opencode/skills/`(Opencode)、`~/.openclaw/skills/`(OpenClaw)、`~/.agents/skills/`(Codex)、`~/.autohand/skills/`(Autohand Code 全局)和 `<project>/.autohand/skills/`(Autohand Code 项目级)。同时已索引于 [SkillsMP](https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md)。
+宿主条目必须把 skill 呈现为 `<skills root>/drawio-skill/SKILL.md`。不要把仓库根目录克隆进 skills 目录。这种嵌套根目录不符合文档记录的一层布局,是否递归发现嵌套根目录因宿主而异。如果已经装有 `drawio-skill`,请先把旧条目移到别处再创建新条目,或者复用稳定位置的源克隆目录。早期安装若把仓库根目录克隆进了 skills 目录,可以把它复用为克隆目录,或者移走。
-Autohand Code 支持通过 `autohand --skill-install` 安装已收录在 Autohand catalog 中的 skill,并可通过 `--project` 安装到当前项目。在该 skill 收录前,请使用上面的直接克隆方式。
+常用路径:`~/.claude/skills/`(Claude Code)、`.claude/skills/`(Claude Code 项目级)、`~/.config/opencode/skills/`(Opencode)、`~/.openclaw/skills/`(OpenClaw)、`~/.agents/skills/`(Codex)、`~/.autohand/skills/`(Autohand Code 全局)和 `<project>/.autohand/skills/`(Autohand Code 项目级)。同时已索引于 [SkillsMP](https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md)。
+
+Autohand Code 支持通过 `autohand --skill-install` 安装已收录在 Autohand catalog 中的 skill,并可通过 `--project` 安装到当前项目。在该 skill 收录前,请按上面的手动安装方式,把 `skills/drawio-skill` 链接进 `~/.autohand/skills/`(全局)或 `<project>/.autohand/skills/`(项目级)。
## 更新
-按你的安装渠道走对应的更新命令:
+推荐的更新命令由 `npx skills` 安装器提供。SkillsMP 只是索引:它不安装也不更新 skill。
```bash
-# SkillsMP
-skills update drawio-skill
+# Global install made with the skills CLI
+npx skills update drawio-skill -g
```
-通过 `git clone` 手动安装的用户,在安装目录下拉取:
+链接安装跟随克隆目录,更新克隆即可更新 skill:
```bash
-cd <你的安装路径>/drawio-skill && git pull
+git -C ~/src/drawio-skill pull
```
+
+复制安装不跟随克隆目录。先更新克隆,再把 `skills/drawio-skill/` 重新复制到一个空目标。请先移走旧副本:往已存在的 `drawio-skill` 目录里复制会嵌套出第二份副本。
diff --git a/docs/index.html b/docs/index.html
index 7c2ba05..5129106 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -959,40 +959,92 @@
</div>
<div id="tab-claude" class="tab-content active" role="tabpanel">
<pre>
-# Global install
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.claude/skills/drawio-skill
+# Install with the skills CLI (global)
+npx skills add Agents365-ai/drawio-skill -g --agent claude-code
-# Project-level install
-git clone https://github.com/Agents365-ai/drawio-skill.git .claude/skills/drawio-skill</pre>
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# Target entries must not exist yet: move an existing drawio-skill entry
+# aside before linking (global and project). Plain ln -s nests inside an existing directory.
+mkdir -p ~/.claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
+
+# Project-level: link the same subdirectory under .claude/skills/
+mkdir -p .claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill .claude/skills/drawio-skill
+
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL.md</pre>
</div>
<div id="tab-opencode" class="tab-content" role="tabpanel">
<pre>
-# Global install (Opencode-native path)
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.config/opencode/skills/drawio-skill
+# Install with the skills CLI (global)
+npx skills add Agents365-ai/drawio-skill -g --agent opencode
-# Project-level install
-git clone https://github.com/Agents365-ai/drawio-skill.git .opencode/skills/drawio-skill
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
-# Also auto-detected from existing Claude Code install
-# (~/.claude/skills/ and .claude/skills/ are read automatically)</pre>
+# Target entries must not exist yet: move an existing drawio-skill entry
+# aside before linking (global and project). Plain ln -s nests inside an existing directory.
+mkdir -p ~/.config/opencode/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.config/opencode/skills/drawio-skill
+
+# Project-level: link the same subdirectory under .opencode/skills/
+mkdir -p .opencode/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill .opencode/skills/drawio-skill
+
+# Opencode also reads ~/.claude/skills/ and .claude/skills/ automatically
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL.md</pre>
</div>
<div id="tab-openclaw" class="tab-content" role="tabpanel">
<pre>
-# Manual install
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.openclaw/skills/drawio-skill</pre>
+# Install with the skills CLI (global)
+npx skills add Agents365-ai/drawio-skill -g --agent openclaw
+
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# The target entry must not exist yet: move an existing drawio-skill entry
+# aside before linking. Plain ln -s nests inside an existing directory.
+mkdir -p ~/.openclaw/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.openclaw/skills/drawio-skill
+
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL.md</pre>
</div>
<div id="tab-skillsmp" class="tab-content" role="tabpanel">
<pre>
-# Via SkillsMP CLI
-skills install drawio-skill</pre>
+# SkillsMP is an index, not an installer. Listing:
+# https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md
+
+# Install with the skills CLI
+npx skills add Agents365-ai/drawio-skill -g</pre>
</div>
<div id="tab-codex" class="tab-content" role="tabpanel">
<pre>
-# User-level install
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.agents/skills/drawio-skill
+# Install with the skills CLI (user-level)
+npx skills add Agents365-ai/drawio-skill -g --agent codex
+
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# Target entries must not exist yet: move an existing drawio-skill entry
+# aside before linking (global and project). Plain ln -s nests inside an existing directory.
+mkdir -p ~/.agents/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.agents/skills/drawio-skill
+
+# Project-level: link the same subdirectory under .agents/skills/
+mkdir -p .agents/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill .agents/skills/drawio-skill
-# Project-level install
-git clone https://github.com/Agents365-ai/drawio-skill.git .agents/skills/drawio-skill</pre>
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL.md</pre>
</div>
</div>
</section>
diff --git a/docs/zh.html b/docs/zh.html
index 0413b99..4ef6161 100644
--- a/docs/zh.html
+++ b/docs/zh.html
@@ -931,40 +931,92 @@
</div>
<div id="tab-claude" class="tab-content active" role="tabpanel">
<pre>
-# 全局安装
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.claude/skills/drawio-skill
+# Install with the skills CLI (global)
+npx skills add Agents365-ai/drawio-skill -g --agent claude-code
-# 项目级安装
-git clone https://github.com/Agents365-ai/drawio-skill.git .claude/skills/drawio-skill</pre>
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# Target entries must not exist yet: move an existing drawio-skill entry
+# aside before linking (global and project). Plain ln -s nests inside an existing directory.
+mkdir -p ~/.claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.claude/skills/drawio-skill
+
+# Project-level: link the same subdirectory under .claude/skills/
+mkdir -p .claude/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill .claude/skills/drawio-skill
+
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL_CN.md</pre>
</div>
<div id="tab-opencode" class="tab-content" role="tabpanel">
<pre>
-# 全局安装(Opencode 原生路径)
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.config/opencode/skills/drawio-skill
+# Install with the skills CLI (global)
+npx skills add Agents365-ai/drawio-skill -g --agent opencode
-# 项目级安装
-git clone https://github.com/Agents365-ai/drawio-skill.git .opencode/skills/drawio-skill
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
-# 也可自动识别已有的 Claude Code 安装
-# (~/.claude/skills/ 和 .claude/skills/ 会被自动读取)</pre>
+# Target entries must not exist yet: move an existing drawio-skill entry
+# aside before linking (global and project). Plain ln -s nests inside an existing directory.
+mkdir -p ~/.config/opencode/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.config/opencode/skills/drawio-skill
+
+# Project-level: link the same subdirectory under .opencode/skills/
+mkdir -p .opencode/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill .opencode/skills/drawio-skill
+
+# Opencode also reads ~/.claude/skills/ and .claude/skills/ automatically
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL_CN.md</pre>
</div>
<div id="tab-openclaw" class="tab-content" role="tabpanel">
<pre>
-# 手动安装
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.openclaw/skills/drawio-skill</pre>
+# Install with the skills CLI (global)
+npx skills add Agents365-ai/drawio-skill -g --agent openclaw
+
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# The target entry must not exist yet: move an existing drawio-skill entry
+# aside before linking. Plain ln -s nests inside an existing directory.
+mkdir -p ~/.openclaw/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.openclaw/skills/drawio-skill
+
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL_CN.md</pre>
</div>
<div id="tab-skillsmp" class="tab-content" role="tabpanel">
<pre>
-# 通过 SkillsMP CLI
-skills install drawio-skill</pre>
+# SkillsMP is an index, not an installer. Listing:
+# https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md
+
+# Install with the skills CLI
+npx skills add Agents365-ai/drawio-skill -g</pre>
</div>
<div id="tab-codex" class="tab-content" role="tabpanel">
<pre>
-# 用户级安装
-git clone https://github.com/Agents365-ai/drawio-skill.git ~/.agents/skills/drawio-skill
+# Install with the skills CLI (user-level)
+npx skills add Agents365-ai/drawio-skill -g --agent codex
+
+# Manual alternative: clone once, then link the skill subdirectory
+# Use an unused source location, or skip this clone if you already have a clone to reuse
+mkdir -p ~/src
+git clone https://github.com/Agents365-ai/drawio-skill.git ~/src/drawio-skill
+
+# Target entries must not exist yet: move an existing drawio-skill entry
+# aside before linking (global and project). Plain ln -s nests inside an existing directory.
+mkdir -p ~/.agents/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill ~/.agents/skills/drawio-skill
+
+# Project-level: link the same subdirectory under .agents/skills/
+mkdir -p .agents/skills
+ln -s ~/src/drawio-skill/skills/drawio-skill .agents/skills/drawio-skill
-# 项目级安装
-git clone https://github.com/Agents365-ai/drawio-skill.git .agents/skills/drawio-skill</pre>
+# Guide: https://github.com/Agents365-ai/drawio-skill/blob/main/docs/INSTALL_SKILL_CN.md</pre>
</div>
</div>
</section>
diff --git a/skills/drawio-skill/SKILL.md b/skills/drawio-skill/SKILL.md
index 7916b6b..9ee1043 100644
--- a/skills/drawio-skill/SKILL.md
+++ b/skills/drawio-skill/SKILL.md
@@ -4,7 +4,7 @@ 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.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"]}
+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
diff --git a/tests/test_skill_metadata.py b/tests/test_skill_metadata.py
index 8bf962c..884af69 100644
--- a/tests/test_skill_metadata.py
+++ b/tests/test_skill_metadata.py
@@ -20,7 +20,7 @@ class TestSkillMetadata(unittest.TestCase):
assert metadata_match is not None
metadata = json.loads(metadata_match.group(1))
- self.assertEqual("3.4.2", metadata.get("version"))
+ self.assertEqual("3.4.3", metadata.get("version"))
self.assertEqual(
"https://github.com/Agents365-ai/drawio-skill", metadata.get("homepage")
)