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: move split sub-docs into docs/, GitHub Pages site to site/

Agents365-ai130d24deb528
diff --git a/.gitignore b/.gitignore
index 1299871..d15a9c6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,4 +11,4 @@ __pycache__/
.last_update
# Superpowers skill files (local-only)
-docs/superpowers
+site/superpowers
diff --git a/README.md b/README.md
index b39eb37..5120aa7 100644
--- a/README.md
+++ b/README.md
@@ -14,11 +14,11 @@ Works with Claude Code, Cursor, Copilot, OpenClaw, Codex, Hermes, and any agent
| Doc | What's inside |
|---|---|
-| [COMPARISON.md](COMPARISON.md) | Side-by-side tables vs. native agents and other draw.io skills/tools, with key-advantages summary |
-| [INSTALL_CLI.md](INSTALL_CLI.md) | draw.io desktop CLI install recipes for macOS / Windows / Linux |
-| [INSTALL_SKILL.md](INSTALL_SKILL.md) | Plugin marketplace, manual clone, and update commands |
-| [USAGE.md](USAGE.md) | Natural-language prompts, microservices walkthrough, topology demos (star / layered / ring) |
-| [STYLE_PRESETS.md](STYLE_PRESETS.md) | Built-in presets, "learn my style from a file" workflow, manage-presets commands |
+| [docs/COMPARISON.md](docs/COMPARISON.md) | Side-by-side tables vs. native agents and other draw.io skills/tools, with key-advantages summary |
+| [docs/INSTALL_CLI.md](docs/INSTALL_CLI.md) | draw.io desktop CLI install recipes for macOS / Windows / Linux |
+| [docs/INSTALL_SKILL.md](docs/INSTALL_SKILL.md) | Plugin marketplace, manual clone, and update commands |
+| [docs/USAGE.md](docs/USAGE.md) | Natural-language prompts, microservices walkthrough, topology demos (star / layered / ring) |
+| [docs/STYLE_PRESETS.md](docs/STYLE_PRESETS.md) | Built-in presets, "learn my style from a file" workflow, manage-presets commands |
| [skills/drawio-skill/SKILL.md](skills/drawio-skill/SKILL.md) | Workflow guide loaded by the agent |
## What it does
@@ -45,7 +45,7 @@ Works with Claude Code, Cursor, Copilot, OpenClaw, Codex, Hermes, and any agent
## Quick Start
-Two steps — install the draw.io CLI first (see [INSTALL_CLI.md](INSTALL_CLI.md)), then drop the skill into your host (see [INSTALL_SKILL.md](INSTALL_SKILL.md)). After that, just describe what you want:
+Two steps — install the draw.io CLI first (see [docs/INSTALL_CLI.md](docs/INSTALL_CLI.md)), then drop the skill into your host (see [docs/INSTALL_SKILL.md](docs/INSTALL_SKILL.md)). After that, just describe what you want:
```
Create a microservices e-commerce architecture with API Gateway, auth/user/order/product/payment services,
diff --git a/README_CN.md b/README_CN.md
index 8687ba9..e8e0575 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -14,11 +14,11 @@
| 文档 | 内容 |
|---|---|
-| [COMPARISON_CN.md](COMPARISON_CN.md) | 与原生智能体、其他 draw.io skills/工具的对照表与核心优势 |
-| [INSTALL_CLI_CN.md](INSTALL_CLI_CN.md) | macOS / Windows / Linux 各平台的 draw.io 桌面版 CLI 安装配方 |
-| [INSTALL_SKILL_CN.md](INSTALL_SKILL_CN.md) | 插件市场、手动克隆与更新命令 |
-| [USAGE_CN.md](USAGE_CN.md) | 自然语言提示词、微服务示例、多种拓扑演示(星形 / 分层 / 环形) |
-| [STYLE_PRESETS_CN.md](STYLE_PRESETS_CN.md) | 内置预设、"从文件学习样式"流程、完整的预设管理命令 |
+| [docs/COMPARISON_CN.md](docs/COMPARISON_CN.md) | 与原生智能体、其他 draw.io skills/工具的对照表与核心优势 |
+| [docs/INSTALL_CLI_CN.md](docs/INSTALL_CLI_CN.md) | macOS / Windows / Linux 各平台的 draw.io 桌面版 CLI 安装配方 |
+| [docs/INSTALL_SKILL_CN.md](docs/INSTALL_SKILL_CN.md) | 插件市场、手动克隆与更新命令 |
+| [docs/USAGE_CN.md](docs/USAGE_CN.md) | 自然语言提示词、微服务示例、多种拓扑演示(星形 / 分层 / 环形) |
+| [docs/STYLE_PRESETS_CN.md](docs/STYLE_PRESETS_CN.md) | 内置预设、"从文件学习样式"流程、完整的预设管理命令 |
| [skills/drawio-skill/SKILL.md](skills/drawio-skill/SKILL.md) | agent 加载的工作流指南 |
## 功能说明
@@ -45,7 +45,7 @@
## 快速开始
-两步 —— 先装 draw.io CLI(见 [INSTALL_CLI_CN.md](INSTALL_CLI_CN.md)),再把技能加载到 host(见 [INSTALL_SKILL_CN.md](INSTALL_SKILL_CN.md))。装好之后直接描述你想要的:
+两步 —— 先装 draw.io CLI(见 [docs/INSTALL_CLI_CN.md](docs/INSTALL_CLI_CN.md)),再把技能加载到 host(见 [docs/INSTALL_SKILL_CN.md](docs/INSTALL_SKILL_CN.md))。装好之后直接描述你想要的:
```
画一个微服务电商架构图,包含 API Gateway、用户/订单/商品/支付服务、
diff --git a/COMPARISON.md b/docs/COMPARISON.md
similarity index 100%
rename from COMPARISON.md
rename to docs/COMPARISON.md
diff --git a/COMPARISON_CN.md b/docs/COMPARISON_CN.md
similarity index 100%
rename from COMPARISON_CN.md
rename to docs/COMPARISON_CN.md
diff --git a/INSTALL_CLI.md b/docs/INSTALL_CLI.md
similarity index 100%
rename from INSTALL_CLI.md
rename to docs/INSTALL_CLI.md
diff --git a/INSTALL_CLI_CN.md b/docs/INSTALL_CLI_CN.md
similarity index 100%
rename from INSTALL_CLI_CN.md
rename to docs/INSTALL_CLI_CN.md
diff --git a/INSTALL_SKILL.md b/docs/INSTALL_SKILL.md
similarity index 100%
rename from INSTALL_SKILL.md
rename to docs/INSTALL_SKILL.md
diff --git a/INSTALL_SKILL_CN.md b/docs/INSTALL_SKILL_CN.md
similarity index 100%
rename from INSTALL_SKILL_CN.md
rename to docs/INSTALL_SKILL_CN.md
diff --git a/STYLE_PRESETS.md b/docs/STYLE_PRESETS.md
similarity index 100%
rename from STYLE_PRESETS.md
rename to docs/STYLE_PRESETS.md
diff --git a/STYLE_PRESETS_CN.md b/docs/STYLE_PRESETS_CN.md
similarity index 100%
rename from STYLE_PRESETS_CN.md
rename to docs/STYLE_PRESETS_CN.md
diff --git a/USAGE.md b/docs/USAGE.md
similarity index 86%
rename from USAGE.md
rename to docs/USAGE.md
index 8f3197f..f05b618 100644
--- a/USAGE.md
+++ b/docs/USAGE.md
@@ -20,7 +20,7 @@ The agent will generate the `.drawio` XML file and export it to PNG automaticall
**Output:**
-![Microservices Architecture](assets/microservices-example.png)
+![Microservices Architecture](../assets/microservices-example.png)
## Topology demos
@@ -30,16 +30,16 @@ The skill handles various diagram topologies with clean edge routing — no line
Central message broker with 6 microservices radiating outward. Edges enter Kafka from different sides, zero crossings.
-![Star topology](assets/demo-star.png)
+![Star topology](../assets/demo-star.png)
### Layered flow (10 nodes, 4 tiers)
E-commerce architecture with 2 cross-connections: Order→Product (same-tier horizontal) and Auth→Redis (diagonal via routing corridor). All edges route cleanly.
-![Layered flow](assets/demo-layered.png)
+![Layered flow](../assets/demo-layered.png)
### Ring / cycle (8 nodes)
CI/CD pipeline with a closed loop and 2 spur branches. Edges flow along the perimeter without crossing the interior.
-![Ring cycle](assets/demo-ring.png)
+![Ring cycle](../assets/demo-ring.png)
diff --git a/USAGE_CN.md b/docs/USAGE_CN.md
similarity index 86%
rename from USAGE_CN.md
rename to docs/USAGE_CN.md
index e06a67b..73a01d8 100644
--- a/USAGE_CN.md
+++ b/docs/USAGE_CN.md
@@ -21,7 +21,7 @@ Auth/User/Order/Product/Payment 微服务,Kafka 消息队列,Notification
**输出效果:**
-![微服务架构图](assets/microservices-example.png)
+![微服务架构图](../assets/microservices-example.png)
## 拓扑示例
@@ -31,16 +31,16 @@ Auth/User/Order/Product/Payment 微服务,Kafka 消息队列,Notification
中央消息代理 + 6 个微服务辐射排列。连线从不同方向进入 Kafka,零交叉。
-![星形拓扑](assets/demo-star-cn.png)
+![星形拓扑](../assets/demo-star-cn.png)
### 分层流程(10 个节点,4 层)
电商架构,含 2 条交叉连线:订单→商品(同层水平)和 认证→Redis(对角线,经路由走廊绕行)。所有线条路由清晰。
-![分层流程](assets/demo-layered-cn.png)
+![分层流程](../assets/demo-layered-cn.png)
### 环形 / 循环(8 个节点)
CI/CD 流水线,包含闭合回路和 2 个分支。线条沿矩形外围流动,不穿越内部区域。
-![环形拓扑](assets/demo-ring-cn.png)
+![环形拓扑](../assets/demo-ring-cn.png)
diff --git a/docs/index.html b/site/index.html
similarity index 100%
rename from docs/index.html
rename to site/index.html
diff --git a/docs/zh.html b/site/zh.html
similarity index 100%
rename from docs/zh.html
rename to site/zh.html