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: split Style Presets into STYLE_PRESETS.md, promote workflow to hero

Agents365-ai23128a03cd9b
diff --git a/README.md b/README.md
index dfa4d84..71508ec 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,10 @@
[中文文档](README_CN.md) | [Online Docs](https://agents365-ai.github.io/drawio-skill/)
+<p align="center">
+ <img src="assets/workflow.png" width="420" alt="Workflow">
+</p>
+
## What it does
| Capability | Description |
@@ -34,12 +38,6 @@ See [COMPARISON.md](COMPARISON.md) for side-by-side tables vs. native agents and
| Data | ER diagrams, data flow diagrams (DFD) | Table containers, PK/FK notation |
| Other | org charts, mind maps, wireframes | — |
-## How it works
-
-<p align="center">
- <img src="assets/workflow.png" width="420" alt="Workflow">
-</p>
-
## Installation
Two steps — install the draw.io CLI first, then drop the skill into your host:
@@ -53,49 +51,7 @@ See [USAGE.md](USAGE.md) for natural-language prompts, a microservices walkthrou
## Style Presets
-Style presets let you capture and reuse a visual style across diagrams. When a preset is active, it replaces the built-in color palette, shape vocabulary, fonts, and edge defaults.
-
-### Built-in presets
-
-| Name | Description |
-|------|-------------|
-| `default` | Clean blue/green/yellow palette matching the built-in conventions |
-| `corporate` | Muted, professional palette suited for business presentations |
-| `handdrawn` | Sketch-style strokes for informal or whiteboard-style diagrams |
-
-### Apply a preset to a diagram
-
-```
-Draw a microservices architecture using my "corporate" style
-```
-
-Or set a default so all future diagrams use it automatically:
-
-```
-Make "corporate" my default style
-```
-
-### Learn your style from a file
-
-Point the skill at any `.drawio` file or flat image:
-
-```
-Learn my style from ~/diagrams/brand.drawio as "mybrand"
-Learn my style from ~/diagrams/screenshot.png as "mybrand"
-```
-
-The skill extracts colors, shapes, fonts, and edge style, renders a sample diagram for preview, and saves to `~/.drawio-skill/styles/mybrand.json` only after you approve.
-
-### Manage presets
-
-| What you say | What happens |
-|---|---|
-| "list my styles" | Shows all user and built-in presets in a table |
-| "show my `<name>` style" | Pretty-prints the preset JSON |
-| "make `<name>` the default" | Sets it as the active default for all diagrams |
-| "remove default" | Clears the default (reverts to built-in conventions) |
-| "delete `<name>`" | Deletes the user preset (prompts for confirmation) |
-| "rename `<a>` to `<b>`" | Renames a user preset |
+See [STYLE_PRESETS.md](STYLE_PRESETS.md) for the built-in presets (`default` / `corporate` / `handdrawn`), the "learn my style from a file" workflow, and the full set of manage-presets commands.
## Support
diff --git a/README_CN.md b/README_CN.md
index 361c5b6..2f44f35 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -2,6 +2,10 @@
[English](README.md) | [Online Docs](https://agents365-ai.github.io/drawio-skill/)
+<p align="center">
+ <img src="assets/workflow-cn.png" width="420" alt="工作流程">
+</p>
+
## 功能说明
| 能力 | 说明 |
@@ -34,12 +38,6 @@
| 数据图 | ER 图、数据流图(DFD) | 表容器、PK/FK 标记 |
| 其他 | 组织架构图、思维导图、线框图 | — |
-## 工作流程
-
-<p align="center">
- <img src="assets/workflow-cn.png" width="420" alt="工作流程">
-</p>
-
## 安装
两步 —— 先装 draw.io CLI,再把技能加载到 host:
@@ -53,49 +51,7 @@
## 样式预设
-样式预设让你捕获并复用视觉风格,跨多张图表保持一致。激活预设后,它会替代内置的配色、形状词汇、字体和连线默认值。
-
-### 内置预设
-
-| 名称 | 说明 |
-|------|------|
-| `default` | 干净的蓝/绿/黄配色,与内置规范保持一致 |
-| `corporate` | 低饱和度专业配色,适合商务演示 |
-| `handdrawn` | 手绘描边风格,适合非正式或白板式图表 |
-
-### 将预设应用到图表
-
-```
-画一个微服务架构图,使用我的 "corporate" 样式
-```
-
-或者设置默认样式,让后续所有图表自动使用:
-
-```
-把 "corporate" 设为我的默认样式
-```
-
-### 从文件中学习样式
-
-指向任意 `.drawio` 文件或图片:
-
-```
-从 ~/diagrams/brand.drawio 学习我的样式,保存为 "mybrand"
-从 ~/diagrams/screenshot.png 学习我的样式,保存为 "mybrand"
-```
-
-Skill 会自动提取配色、形状、字体和连线风格,渲染样例图供预览,确认后才保存至 `~/.drawio-skill/styles/mybrand.json`。
-
-### 管理预设
-
-| 你说的话 | 发生什么 |
-|---|---|
-| "列出我的样式" | 以表格展示所有用户和内置预设 |
-| "显示我的 `<name>` 样式" | 格式化输出预设 JSON |
-| "把 `<name>` 设为默认" | 设为所有图表的默认激活预设 |
-| "取消默认" | 清除默认(恢复内置规范) |
-| "删除 `<name>`" | 删除用户预设(会请求确认) |
-| "把 `<a>` 重命名为 `<b>`" | 重命名用户预设 |
+参见 [STYLE_PRESETS_CN.md](STYLE_PRESETS_CN.md) —— 包含内置预设(`default` / `corporate` / `handdrawn`)、"从文件学习样式"流程,以及完整的预设管理命令。
## 支持作者
diff --git a/STYLE_PRESETS.md b/STYLE_PRESETS.md
new file mode 100644
index 0000000..8380b0a
--- /dev/null
+++ b/STYLE_PRESETS.md
@@ -0,0 +1,47 @@
+# Style Presets
+
+[中文](STYLE_PRESETS_CN.md)
+
+Style presets let you capture and reuse a visual style across diagrams. When a preset is active, it replaces the built-in color palette, shape vocabulary, fonts, and edge defaults.
+
+## Built-in presets
+
+| Name | Description |
+|------|-------------|
+| `default` | Clean blue/green/yellow palette matching the built-in conventions |
+| `corporate` | Muted, professional palette suited for business presentations |
+| `handdrawn` | Sketch-style strokes for informal or whiteboard-style diagrams |
+
+## Apply a preset to a diagram
+
+```
+Draw a microservices architecture using my "corporate" style
+```
+
+Or set a default so all future diagrams use it automatically:
+
+```
+Make "corporate" my default style
+```
+
+## Learn your style from a file
+
+Point the skill at any `.drawio` file or flat image:
+
+```
+Learn my style from ~/diagrams/brand.drawio as "mybrand"
+Learn my style from ~/diagrams/screenshot.png as "mybrand"
+```
+
+The skill extracts colors, shapes, fonts, and edge style, renders a sample diagram for preview, and saves to `~/.drawio-skill/styles/mybrand.json` only after you approve.
+
+## Manage presets
+
+| What you say | What happens |
+|---|---|
+| "list my styles" | Shows all user and built-in presets in a table |
+| "show my `<name>` style" | Pretty-prints the preset JSON |
+| "make `<name>` the default" | Sets it as the active default for all diagrams |
+| "remove default" | Clears the default (reverts to built-in conventions) |
+| "delete `<name>`" | Deletes the user preset (prompts for confirmation) |
+| "rename `<a>` to `<b>`" | Renames a user preset |
diff --git a/STYLE_PRESETS_CN.md b/STYLE_PRESETS_CN.md
new file mode 100644
index 0000000..4ce3428
--- /dev/null
+++ b/STYLE_PRESETS_CN.md
@@ -0,0 +1,47 @@
+# 样式预设
+
+[English](STYLE_PRESETS.md)
+
+样式预设让你捕获并复用视觉风格,跨多张图表保持一致。激活预设后,它会替代内置的配色、形状词汇、字体和连线默认值。
+
+## 内置预设
+
+| 名称 | 说明 |
+|------|------|
+| `default` | 干净的蓝/绿/黄配色,与内置规范保持一致 |
+| `corporate` | 低饱和度专业配色,适合商务演示 |
+| `handdrawn` | 手绘描边风格,适合非正式或白板式图表 |
+
+## 将预设应用到图表
+
+```
+画一个微服务架构图,使用我的 "corporate" 样式
+```
+
+或者设置默认样式,让后续所有图表自动使用:
+
+```
+把 "corporate" 设为我的默认样式
+```
+
+## 从文件中学习样式
+
+指向任意 `.drawio` 文件或图片:
+
+```
+从 ~/diagrams/brand.drawio 学习我的样式,保存为 "mybrand"
+从 ~/diagrams/screenshot.png 学习我的样式,保存为 "mybrand"
+```
+
+Skill 会自动提取配色、形状、字体和连线风格,渲染样例图供预览,确认后才保存至 `~/.drawio-skill/styles/mybrand.json`。
+
+## 管理预设
+
+| 你说的话 | 发生什么 |
+|---|---|
+| "列出我的样式" | 以表格展示所有用户和内置预设 |
+| "显示我的 `<name>` 样式" | 格式化输出预设 JSON |
+| "把 `<name>` 设为默认" | 设为所有图表的默认激活预设 |
+| "取消默认" | 清除默认(恢复内置规范) |
+| "删除 `<name>`" | 删除用户预设(会请求确认) |
+| "把 `<a>` 重命名为 `<b>`" | 重命名用户预设 |