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: update READMEs for multi-agent messaging

Agents365-ai8d760a5f3c99
diff --git a/README.md b/README.md
index 1d19458..d9df022 100644
--- a/README.md
+++ b/README.md
@@ -10,18 +10,30 @@
- Iterative design: preview, get feedback, and refine diagrams until they look right
- Triggers automatically when diagrams would help explain complex systems
+## Multi-Platform Support
+
+Works with all major AI coding agents that support the [Agent Skills](https://agentskills.io) format:
+
+| Platform | Status | Details |
+|----------|--------|---------|
+| **Claude Code** | ✅ Full support | Native SKILL.md format |
+| **OpenClaw** | ✅ Full support | `metadata.openclaw` namespace, dependency gating, installer |
+| **Hermes Agent** | ✅ Full support | `metadata.hermes` namespace, tags, tool gating |
+| **OpenAI Codex** | ✅ Full support | `agents/openai.yaml` sidecar file |
+| **SkillsMP** | ✅ Indexed | GitHub topics configured |
+
## Comparison
-### vs Native Claude Code (no skill)
+### vs No Skill (native agent)
-| Feature | Native Claude Code | This skill |
-|---------|-------------------|------------|
-| Generate draw.io XML | Yes — Claude knows the format | Yes |
+| Feature | Native agent | This skill |
+|---------|-------------|------------|
+| Generate draw.io XML | Yes — LLMs know the format | Yes |
| Self-check after export | No | Yes — reads PNG and auto-fixes 6 issue types |
| Iterative review loop | No — must manually re-prompt | Yes — targeted edits, 5-round safety valve |
| Proactive triggers | No — only when explicitly asked | Yes — auto-suggests when 3+ components |
| Layout guidelines | None — varies by run | Complexity-scaled spacing, routing corridors, hub placement |
-| Color palette | Random/inconsistent | 7-color semantic system (blue=services, green=DB, purple=auth…) |
+| Color palette | Random/inconsistent | 7-color semantic system (blue=services, green=DB, purple=auth...) |
| Edge routing rules | Basic | Pin entry/exit points, distribute connections, waypoint corridors |
| Container/group patterns | None | Swimlane, group, custom container with parent-child nesting |
| Embed diagram in export | No | Yes — `--embed-diagram` keeps exported PNG/SVG/PDF editable |
@@ -33,6 +45,7 @@
|---------|-----------|---------------|-------------------|--------------|
| **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** | ✅ 5 platforms | ❌ Claude Code only | ❌ Claude Code only | ❌ |
| **Self-check** | ✅ 2-round auto-fix | ❌ | ❌ | ❌ screenshot |
| **Iterative review** | ✅ 5-round loop | ❌ generate once | ✅ 3 workflows | ❌ |
| **Layout guidance** | ✅ complexity-scaled | ✅ basic spacing | ❌ relies on MCP | ❌ |
@@ -44,10 +57,10 @@
| **Cloud icons** | AWS basic | ❌ | ✅ AWS/GCP/Azure/K8s | ❌ |
| **Zero-config** | ✅ copy SKILL.md | ✅ | ❌ needs `npx` | ❌ needs plugin install |
-### Key advantages of this skill
+### Key advantages
1. **Self-check + iterative loop** — the only pure-SKILL.md solution that reads its own output and auto-fixes before showing the user, then supports multi-round refinement
-2. **Zero-config, zero-dependency** — just one `SKILL.md` file + draw.io desktop. No MCP server, no Python, no Node.js, no browser
+2. **Multi-agent, zero-config** — works across 5 platforms with just one `SKILL.md` file + draw.io desktop. No MCP server, no Python, no Node.js, no browser
3. **Production-grade layout** — complexity-scaled spacing, routing corridors, hub-center strategy, connection distribution rules
4. **Full Chinese support** — proactive triggers ("画图", "架构图"), bilingual documentation
@@ -65,15 +78,9 @@
<img src="assets/workflow.png" width="420" alt="Workflow">
</p>
-## Dependencies
-
-| Tool | Purpose |
-|------|---------|
-| `draw.io` desktop app | Native CLI to export `.drawio` → PNG/SVG/PDF |
-
-No browser automation or Node.js dependency required.
+## Prerequisites
-## Install
+The draw.io desktop app must be installed for diagram export:
### macOS
@@ -104,8 +111,6 @@ sudo apt install xvfb # Debian/Ubuntu
xvfb-run -a drawio --version
```
-### Platform notes
-
| Platform | Extra step |
|----------|------------|
| **macOS** | No extra steps after Homebrew install |
@@ -189,7 +194,7 @@ Create a microservices e-commerce architecture with API Gateway, auth/user/order
Kafka message queue, notification service, and separate databases for each service
```
-Claude will generate the `.drawio` XML file and export it to PNG automatically.
+The agent will generate the `.drawio` XML file and export it to PNG automatically.
## Example
@@ -224,18 +229,6 @@ CI/CD pipeline with a closed loop and 2 spur branches. Edges flow along the peri
![Ring cycle](assets/demo-ring.png)
-## Multi-Platform Support
-
-This skill is compatible with the following platforms:
-
-| Platform | Status | Details |
-|----------|--------|---------|
-| **Claude Code** | ✅ Full support | Native SKILL.md format |
-| **OpenClaw** | ✅ Full support | `metadata.openclaw` namespace, dependency gating, installer |
-| **Hermes Agent** | ✅ Full support | `metadata.hermes` namespace, tags, tool gating |
-| **OpenAI Codex** | ✅ Full support | `agents/openai.yaml` sidecar file |
-| **SkillsMP** | ✅ Indexed | GitHub topics configured |
-
## Files
- `SKILL.md` — **the only required file**. Loaded by all platforms as the skill instructions.
@@ -244,9 +237,9 @@ This skill is compatible with the following platforms:
- `README_CN.md` — Chinese documentation
- `assets/` — example diagrams and workflow images
-> **Note:** Only `SKILL.md` is needed for the skill to work. `agents/openai.yaml` is only needed for Codex. The `assets/`, `README.md`, and `README_EN.md` files are documentation only and can be safely deleted to save space.
+> **Note:** Only `SKILL.md` is needed for the skill to work. `agents/openai.yaml` is only needed for Codex. The `assets/` and README files are documentation only and can be safely deleted to save space.
-> All example diagrams were generated in Claude Code with Claude Opus 4.6.
+> All example diagrams were generated by Claude Opus 4.6 with this skill.
## License
diff --git a/README_CN.md b/README_CN.md
index 40af121..b27e38d 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -10,13 +10,25 @@
- 迭代设计:预览、获取反馈、反复优化直到图表满意为止
- 当图表有助于解释复杂系统时自动触发
+## 多平台支持
+
+兼容所有主流支持 [Agent Skills](https://agentskills.io) 格式的 AI 编码智能体:
+
+| 平台 | 支持状态 | 说明 |
+|------|----------|------|
+| **Claude Code** | ✅ 完全支持 | 原生 SKILL.md 格式 |
+| **OpenClaw** | ✅ 完全支持 | `metadata.openclaw` 命名空间,依赖检测,安装器 |
+| **Hermes Agent** | ✅ 完全支持 | `metadata.hermes` 命名空间,标签分类,工具门控 |
+| **OpenAI Codex** | ✅ 完全支持 | `agents/openai.yaml` 侧车文件 |
+| **SkillsMP** | ✅ 可索引 | GitHub topics 已配置 |
+
## 对比
-### 与原生 Claude Code(无 skill)对比
+### 与无 skill 的原生智能体对比
-| 功能 | 原生 Claude Code | 本 skill |
-|------|-----------------|---------|
-| 生成 draw.io XML | 是 — Claude 本身了解格式 | 是 |
+| 功能 | 原生智能体 | 本 skill |
+|------|-----------|---------|
+| 生成 draw.io XML | 是 — LLM 本身了解格式 | 是 |
| 导出后自检 | 否 | 是 — 读取 PNG 自动修复 6 类问题 |
| 迭代反馈循环 | 否 — 需手动重新提问 | 是 — 定向编辑,5 轮安全阀 |
| 主动触发 | 否 — 仅在明确要求时 | 是 — 3+ 组件时自动建议画图 |
@@ -33,6 +45,7 @@
|---------|-----------|---------------|-------------------|--------------|
| **方式** | 纯 SKILL.md | SKILL.md / MCP / Project | YAML DSL + MCP | 插件 + 浏览器 |
| **依赖** | 仅 draw.io 桌面版 | draw.io 桌面版 | MCP 服务(`npx`) | 浏览器 + 本地服务 |
+| **多智能体** | ✅ 5 个平台 | ❌ 仅 Claude Code | ❌ 仅 Claude Code | ❌ |
| **自检** | ✅ 2 轮自动修复 | ❌ | ❌ | ❌ 截图 |
| **迭代审查** | ✅ 5 轮循环 | ❌ 一次生成 | ✅ 3 种工作流 | ❌ |
| **布局指南** | ✅ 按复杂度分级 | ✅ 基础间距 | ❌ 依赖 MCP | ❌ |
@@ -44,10 +57,10 @@
| **云图标** | AWS 基础 | ❌ | ✅ AWS/GCP/Azure/K8s | ❌ |
| **零配置** | ✅ 复制 SKILL.md | ✅ | ❌ 需要 `npx` | ❌ 需安装插件 |
-### 本 skill 核心优势
+### 核心优势
1. **自检 + 迭代循环** — 唯一纯 SKILL.md 方案中能自动读取输出、修复问题、支持多轮优化的
-2. **零配置、零依赖** — 仅需一个 `SKILL.md` 文件 + draw.io 桌面版,无需 MCP、Python、Node.js、浏览器
+2. **多智能体、零配置** — 跨 5 个平台运行,仅需一个 `SKILL.md` 文件 + draw.io 桌面版,无需 MCP、Python、Node.js、浏览器
3. **专业级布局** — 按复杂度分级间距、路由走廊、hub 居中、连接分布规则
4. **完整中文支持** — 主动触发词("画图"、"架构图")、双语文档
@@ -65,15 +78,9 @@
<img src="assets/workflow-cn.png" width="420" alt="工作流程">
</p>
-## 依赖项
-
-| 工具 | 用途 |
-|------|------|
-| `draw.io` 桌面应用 | 原生 CLI,用于将 `.drawio` 导出为 PNG/SVG/PDF |
-
-无需浏览器自动化或 Node.js 依赖。
+## 前置依赖
-## 安装
+需要安装 draw.io 桌面版用于图表导出:
### macOS
@@ -104,8 +111,6 @@ sudo apt install xvfb # Debian/Ubuntu
xvfb-run -a drawio --version
```
-### 平台说明
-
| 平台 | 额外步骤 |
|------|----------|
| **macOS** | Homebrew 安装后无需额外操作 |
@@ -190,7 +195,7 @@ Auth/User/Order/Product/Payment 微服务,Kafka 消息队列,Notification
以及各自独立的数据库
```
-Claude 会自动生成 `.drawio` 文件并导出为 PNG。
+智能体会自动生成 `.drawio` 文件并导出为 PNG。
## 示例
@@ -225,18 +230,6 @@ CI/CD 流水线,包含闭合回路和 2 个分支。线条沿矩形外围流
![环形循环](assets/demo-ring-cn.png)
-## 多平台支持
-
-本 skill 兼容以下平台:
-
-| 平台 | 支持状态 | 说明 |
-|------|----------|------|
-| **Claude Code** | ✅ 完全支持 | 原生 SKILL.md 格式 |
-| **OpenClaw** | ✅ 完全支持 | `metadata.openclaw` 命名空间,依赖检测,安装器 |
-| **Hermes Agent** | ✅ 完全支持 | `metadata.hermes` 命名空间,标签分类,工具门控 |
-| **OpenAI Codex** | ✅ 完全支持 | `agents/openai.yaml` 侧车文件 |
-| **SkillsMP** | ✅ 可索引 | GitHub topics 已配置 |
-
## 文件说明
- `SKILL.md` — **唯一必需的文件**,所有平台加载的 skill 指令
@@ -245,9 +238,9 @@ CI/CD 流水线,包含闭合回路和 2 个分支。线条沿矩形外围流
- `README_CN.md` — 本文件(中文)
- `assets/` — 示例图表和工作流图片
-> **提示:** 仅 `SKILL.md` 是 skill 运行所必需的。`agents/openai.yaml` 仅 Codex 需要。`assets/`、`README.md` 和 `README_EN.md` 仅为文档用途,可以安全删除以节省空间。
+> **提示:** 仅 `SKILL.md` 是 skill 运行所必需的。`agents/openai.yaml` 仅 Codex 需要。`assets/` 和 README 文件仅为文档用途,可以安全删除以节省空间。
-> 所有示例图表均由 Claude Code 配合 Claude Opus 4.6 模型生成。
+> 所有示例图表均由 Claude Opus 4.6 配合本 skill 生成。
## 开源协议