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: add vs Other Tools comparison table to READMEs

Agents365-aibbd54f4733c0
diff --git a/README.md b/README.md
index b6da671..c9f27b6 100644
--- a/README.md
+++ b/README.md
@@ -129,9 +129,9 @@ Learn my style from ~/diagrams/brand.drawio as "mybrand"
The skill extracts colors, shapes, fonts, and edge style, renders a preview, and only saves the preset after you approve. Full preset-management commands in [docs/STYLE_PRESETS.md](docs/STYLE_PRESETS.md).
-## 🆚 Why drawio-skill?
+## 🆚 Comparison
-Compared with a native agent (no skill):
+### vs Native Agent (no skill)
| Feature | Native agent | drawio-skill |
|---|---|---|
@@ -142,7 +142,22 @@ Compared with a native agent (no skill):
| Color palette | random / inconsistent | ✅ 7-color semantic system |
| Style presets | ❌ | ✅ learn from `.drawio` file or image |
-Full comparison with other draw.io skills, MCP servers, and plugins in [docs/COMPARISON.md](docs/COMPARISON.md).
+### vs Other draw.io Skills & Tools
+
+| Feature | drawio-skill | [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp)<br>(official, 1.3k⭐) | [bahayonghang/drawio-skills](https://github.com/bahayonghang/drawio-skills)<br>(60⭐) | [GBSOSS/ai-drawio](https://github.com/GBSOSS/ai-drawio)<br>(63⭐) |
+|---|---|---|---|---|
+| **Approach** | Pure SKILL.md | SKILL.md / MCP / Project | YAML DSL + MCP | Plugin + browser |
+| **Dependencies** | draw.io desktop only | draw.io desktop | MCP server (`npx`) | Browser + local server |
+| **Multi-agent** | ✅ 6 platforms | ❌ Claude Code only | ❌ Claude Code only | ❌ |
+| **Self-check + auto-fix** | ✅ 2-round | ❌ | ❌ | ❌ screenshot only |
+| **Iterative review** | ✅ 5-round loop | ❌ generate once | ✅ 3 workflows | ❌ |
+| **Diagram presets** | ✅ 6 types | ❌ | ❌ | ❌ |
+| **ML/DL diagrams** | ✅ tensor shapes, layer colors | ❌ | ❌ | ❌ |
+| **Color system** | ✅ 7-color semantic | ❌ | ✅ 5 themes | ❌ |
+| **Browser fallback** | ✅ diagrams.net URL | ❌ | ❌ | ❌ |
+| **Zero-config** | ✅ copy `skills/drawio-skill/` | ✅ | ❌ needs `npx` | ❌ needs plugin install |
+
+Full 18-row comparison + key-advantages summary in [docs/COMPARISON.md](docs/COMPARISON.md).
## 📚 Documentation
diff --git a/README_CN.md b/README_CN.md
index 209ccf0..fa133c9 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -128,9 +128,9 @@ Skill 会自动规划布局、生成 `.drawio` XML、导出为你选择的格式
Skill 会提取配色、形状、字体和连线风格,渲染预览图,**确认后**才保存预设。完整管理命令见 [docs/STYLE_PRESETS_CN.md](docs/STYLE_PRESETS_CN.md)。
-## 🆚 为什么用 drawio-skill?
+## 🆚 对比
-对比原生智能体(无 skill):
+### 对比原生智能体(无 skill)
| 功能 | 原生智能体 | drawio-skill |
|------|-----------|--------------|
@@ -141,7 +141,22 @@ Skill 会提取配色、形状、字体和连线风格,渲染预览图,**确
| 配色方案 | 随机 / 不一致 | ✅ 7 色语义系统 |
| 样式预设 | ❌ | ✅ 从 `.drawio` 文件或图片学习 |
-与其他 draw.io skills、MCP 服务、插件的完整对比见 [docs/COMPARISON_CN.md](docs/COMPARISON_CN.md)。
+### 对比其他 draw.io Skills 与工具
+
+| 功能 | drawio-skill | [jgraph/drawio-mcp](https://github.com/jgraph/drawio-mcp)<br>(官方,1.3k⭐) | [bahayonghang/drawio-skills](https://github.com/bahayonghang/drawio-skills)<br>(60⭐) | [GBSOSS/ai-drawio](https://github.com/GBSOSS/ai-drawio)<br>(63⭐) |
+|------|------|------|------|------|
+| **方式** | 纯 SKILL.md | SKILL.md / MCP / Project | YAML DSL + MCP | 插件 + 浏览器 |
+| **依赖** | 仅 draw.io 桌面版 | draw.io 桌面版 | MCP 服务(`npx`) | 浏览器 + 本地服务 |
+| **多智能体支持** | ✅ 6 个平台 | ❌ 仅 Claude Code | ❌ 仅 Claude Code | ❌ |
+| **自检 + 自动修复** | ✅ 2 轮 | ❌ | ❌ | ❌ 仅截图 |
+| **迭代审查** | ✅ 5 轮循环 | ❌ 一次生成 | ✅ 3 种工作流 | ❌ |
+| **图表预设** | ✅ 6 种 | ❌ | ❌ | ❌ |
+| **ML/DL 图** | ✅ 张量标注、层配色 | ❌ | ❌ | ❌ |
+| **配色系统** | ✅ 7 色语义 | ❌ | ✅ 5 种主题 | ❌ |
+| **浏览器降级** | ✅ diagrams.net URL | ❌ | ❌ | ❌ |
+| **零配置** | ✅ 复制 `skills/drawio-skill/` | ✅ | ❌ 需 `npx` | ❌ 需安装插件 |
+
+完整 18 行对比 + 核心优势总结见 [docs/COMPARISON_CN.md](docs/COMPARISON_CN.md)。
## 📚 文档导航