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: update READMEs for multi-agent messaging
Agents365-ai8d760a5f3c99
diff --git a/README.md b/README.mdindex 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 advantages1. **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 browser3. **Production-grade layout** — complexity-scaled spacing, routing corridors, hub-center strategy, connection distribution rules4. **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/Ubuntuxvfb-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/orderKafka 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-## 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.## Licensediff --git a/README_CN.md b/README_CN.mdindex 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/Ubuntuxvfb-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 个分支。线条沿矩形外围流-## 多平台支持--本 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 生成。## 开源协议