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: add vs Other Tools comparison table to READMEs
Agents365-aibbd54f4733c0
diff --git a/README.md b/README.mdindex 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).## 📚 Documentationdiff --git a/README_CN.md b/README_CN.mdindex 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)。## 📚 文档导航