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.

feat(shapes): add AI/LLM brand logos via lobe-icons (aiicons.py) (#23)

Agents365.ai4cd5ff77d3b3
diff --git a/skills/drawio-skill/SKILL.md b/skills/drawio-skill/SKILL.md
index 1f11f36..bf57d9a 100644
--- a/skills/drawio-skill/SKILL.md
+++ b/skills/drawio-skill/SKILL.md
@@ -1,12 +1,12 @@
---
name: drawio-skill
-version: 1.11.1
+version: 1.12.0
description: Use when the user requests diagrams, flowcharts, architecture diagrams, ER diagrams, UML / sequence / class diagrams, network topology, ML/DL model figures (Transformer/CNN/LSTM), mind maps, or any visualization. Also use proactively when explaining systems with 3+ components, complex data flows, or relationships that benefit from visual representation. Best suited when the diagram needs custom styling, rich shape vocabulary, swimlanes, or exportable images (PNG/SVG/PDF/JPG). Generates .drawio XML and exports locally via the native draw.io desktop CLI.
license: MIT
homepage: https://github.com/Agents365-ai/drawio-skill
compatibility: Requires draw.io desktop app CLI on PATH (macOS/Linux/Windows). Self-check step requires a vision-enabled model (e.g., Claude Sonnet/Opus); gracefully skipped if unavailable. Optional auto-layout (scripts/autolayout.py) needs Graphviz (dot).
platforms: [macos, linux, windows]
-metadata: {"openclaw":{"requires":{"anyBins":["draw.io","drawio"]},"emoji":"📐","os":["darwin","linux","win32"],"install":[{"id":"brew-drawio","kind":"brew","formula":"drawio","bins":["drawio"],"label":"Install draw.io via Homebrew","os":["darwin"]},{"id":"brew-graphviz","kind":"brew","formula":"graphviz","bins":["dot"],"label":"Install Graphviz for optional autolayout.py","os":["darwin"],"optional":true}]},"hermes":{"tags":["drawio","diagram","flowchart","architecture","visualization","uml"],"category":"design","requires_tools":["drawio","draw.io"],"related_skills":["mermaid","excalidraw","plantuml"]},"author":"Agents365-ai","version":"1.11.1"}
+metadata: {"openclaw":{"requires":{"anyBins":["draw.io","drawio"]},"emoji":"📐","os":["darwin","linux","win32"],"install":[{"id":"brew-drawio","kind":"brew","formula":"drawio","bins":["drawio"],"label":"Install draw.io via Homebrew","os":["darwin"]},{"id":"brew-graphviz","kind":"brew","formula":"graphviz","bins":["dot"],"label":"Install Graphviz for optional autolayout.py","os":["darwin"],"optional":true}]},"hermes":{"tags":["drawio","diagram","flowchart","architecture","visualization","uml"],"category":"design","requires_tools":["drawio","draw.io"],"related_skills":["mermaid","excalidraw","plantuml"]},"author":"Agents365-ai","version":"1.12.0"}
---
# Draw.io Diagrams
@@ -27,6 +27,7 @@ When the workflow references one of these, read it on demand — none of them ne
|---|---|
| `references/diagram-types.md` | The user names a specific diagram type (ERD, UML class, sequence, architecture, ML/DL, flowchart) |
| `references/shapes.md` + `scripts/shapesearch.py` | The diagram needs a **specific shape** — a cloud icon (AWS/Azure/GCP), Cisco/Kubernetes/network symbol, UML/BPMN/ER/electrical/P&ID element — or any time you'd otherwise guess a `style=` string. `shapesearch.py "<keywords>"` returns the exact official style for 10k+ shapes |
+| `scripts/aiicons.py` | The diagram involves an **AI/LLM brand** (OpenAI, Claude, Gemini, Mistral, Llama, HuggingFace, Ollama, LangChain, …) — `aiicons.py "<brand>"` returns a draw.io `image` style for the brand logo (lobe-icons via CDN; `--embed` to inline). draw.io has no built-in AI logos. See `references/shapes.md` → "AI / LLM brand logos" |
| `references/style-presets.md` | The user asks to learn / save / list / set-default / delete a style preset, or you've resolved an active preset and need the application rules |
| `references/style-extraction.md` | You're inside the Learn flow and need the extraction procedure (called from `style-presets.md`) |
| `references/troubleshooting.md` | An export fails, vision rejects a PNG, or a rendering looks wrong |
@@ -203,7 +204,7 @@ Always lowercase the user-provided name before any file operation — the schema
| `shape=cylinder3;` | cylinder — databases |
| `swimlane;` | group/container with title bar |
-For **vendor/branded icons** (AWS/Azure/GCP/Cisco/Kubernetes) and any non-trivial shape, don't guess the `shape=mxgraph.*` name — a wrong name renders as a blank box. Run `python3 <this-skill-dir>/scripts/shapesearch.py "<keywords>"` to get the exact official style + size, or see `references/shapes.md` for the hand-writable cheatsheet.
+For **vendor/branded icons** (AWS/Azure/GCP/Cisco/Kubernetes) and any non-trivial shape, don't guess the `shape=mxgraph.*` name — a wrong name renders as a blank box. Run `python3 <this-skill-dir>/scripts/shapesearch.py "<keywords>"` to get the exact official style + size, or see `references/shapes.md` for the hand-writable cheatsheet. For **AI/LLM brand logos** (OpenAI, Claude, Gemini, …), which draw.io has none of, use `python3 <this-skill-dir>/scripts/aiicons.py "<brand>"`.
### Required properties
diff --git a/skills/drawio-skill/data/lobe-icons.json b/skills/drawio-skill/data/lobe-icons.json
new file mode 100644
index 0000000..34c1e36
--- /dev/null
+++ b/skills/drawio-skill/data/lobe-icons.json
@@ -0,0 +1,878 @@
+{
+"package": "@lobehub/icons-static-svg",
+"version": "1.91.0",
+"cdn": "https://unpkg.com/@lobehub/[email protected]/icons/",
+"icons": [
+"ace",
+"ace-text",
+"adobe",
+"adobe-color",
+"adobe-text",
+"adobefirefly",
+"adobefirefly-color",
+"adobefirefly-text",
+"agentvoice",
+"agentvoice-color",
+"agentvoice-text",
+"agui",
+"agui-text",
+"ai2",
+"ai2-color",
+"ai2-text",
+"ai21",
+"ai21-brand",
+"ai21-brand-color",
+"ai21-text",
+"ai302",
+"ai302-color",
+"ai302-text",
+"ai360",
+"ai360-color",
+"ai360-text",
+"aihubmix",
+"aihubmix-color",
+"aihubmix-text",
+"aimass",
+"aimass-color",
+"aimass-text",
+"aionlabs",
+"aionlabs-color",
+"aionlabs-text",
+"airjelly",
+"airjelly-color",
+"airjelly-text",
+"aistudio",
+"aistudio-text",
+"akashchat",
+"akashchat-color",
+"akashchat-text",
+"alephalpha",
+"alephalpha-text",
+"alibaba",
+"alibaba-brand",
+"alibaba-brand-color",
+"alibaba-color",
+"alibaba-text",
+"alibaba-text-cn",
+"alibabacloud",
+"alibabacloud-color",
+"alibabacloud-text",
+"alibabacloud-text-cn",
+"amp",
+"amp-color",
+"amp-text",
+"antgroup",
+"antgroup-brand",
+"antgroup-brand-color",
+"antgroup-color",
+"antgroup-text",
+"antgroup-text-cn",
+"anthropic",
+"anthropic-text",
+"antigravity",
+"antigravity-color",
+"antigravity-text",
+"anyscale",
+"anyscale-color",
+"anyscale-text",
+"apertis",
+"apertis-color",
+"apertis-text",
+"apple",
+"apple-text",
+"arcee",
+"arcee-color",
+"arcee-text",
+"askverdict",
+"askverdict-color",
+"askverdict-text",
+"assemblyai",
+"assemblyai-color",
+"assemblyai-text",
+"atlascloud",
+"atlascloud-text",
+"automatic",
+"automatic-color",
+"automatic-text",
+"aws",
+"aws-brand",
+"aws-brand-color",
+"aws-color",
+"aws-text",
+"aya",
+"aya-color",
+"aya-text",
+"azure",
+"azure-color",
+"azure-text",
+"azureai",
+"azureai-color",
+"azureai-text",
+"baai",
+"baai-text",
+"baichuan",
+"baichuan-color",
+"baichuan-text",
+"baidu",
+"baidu-brand",
+"baidu-brand-color",
+"baidu-color",
+"baidu-text",
+"baidu-text-cn",
+"baiducloud",
+"baiducloud-color",
+"baiducloud-text",
+"bailian",
+"bailian-color",
+"bailian-text",
+"baseten",
+"baseten-text",
+"bedrock",
+"bedrock-color",
+"bedrock-text",
+"bfl",
+"bfl-text",
+"bilibili",
+"bilibili-color",
+"bilibili-text",
+"bilibiliindex",
+"bilibiliindex-text",
+"bing",
+"bing-color",
+"bing-text",
+"briaai",
+"briaai-color",
+"briaai-text",
+"burncloud",
+"burncloud-color",
+"burncloud-text",
+"bytedance",
+"bytedance-brand",
+"bytedance-brand-color",
+"bytedance-color",
+"bytedance-text",
+"bytedance-text-cn",
+"capcut",
+"capcut-text",
+"centml",
+"centml-brand",
+"centml-brand-color",
+"centml-color",
+"centml-text",
+"cerebras",
+"cerebras-brand",
+"cerebras-brand-color",
+"cerebras-color",
+"cerebras-text",
+"chatglm",
+"chatglm-color",
+"chatglm-text",
+"cherrystudio",
+"cherrystudio-color",
+"cherrystudio-text",
+"civitai",
+"civitai-color",
+"civitai-text",
+"civitai-text-color",
+"claude",
+"claude-color",
+"claude-text",
+"claudecode",
+"claudecode-color",
+"claudecode-text",
+"cline",
+"cline-text",
+"clipdrop",
+"clipdrop-text",
+"cloudflare",
+"cloudflare-color",
+"cloudflare-text",
+"codebuddy",
+"codebuddy-color",
+"codebuddy-text",
+"codeflicker",
+"codeflicker-color",
+"codeflicker-text",
+"codegeex",
+"codegeex-color",
+"codegeex-text",
+"codex",
+"codex-color",
+"codex-text",
+"cogvideo",
+"cogvideo-color",
+"cogvideo-text",
+"cogview",
+"cogview-color",
+"cogview-text",
+"cohere",
+"cohere-color",
+"cohere-text",
+"colab",
+"colab-color",
+"colab-text",
+"cometapi",
+"cometapi-color",
+"cometapi-text",
+"comfyui",
+"comfyui-color",
+"comfyui-text",
+"commanda",
+"commanda-color",
+"commanda-text",
+"copilot",
+"copilot-color",
+"copilot-text",
+"copilotkit",
+"copilotkit-color",
+"copilotkit-text",
+"coqui",
+"coqui-color",
+"coqui-text",
+"coze",
+"coze-text",
+"crewai",
+"crewai-brand",
+"crewai-brand-color",
+"crewai-color",
+"crewai-text",
+"crusoe",
+"crusoe-color",
+"crusoe-text",
+"cursor",
+"cursor-text",
+"cybercut",
+"cybercut-text",
+"dalle",
+"dalle-color",
+"dalle-text",
+"dbrx",
+"dbrx-brand",
+"dbrx-brand-color",
+"dbrx-color",
+"dbrx-text",
+"deepai",
+"deepai-text",
+"deepcogito",
+"deepcogito-color",
+"deepcogito-text",
+"deepinfra",
+"deepinfra-color",
+"deepinfra-text",
+"deepl",
+"deepl-color",
+"deepl-text",
+"deepmind",
+"deepmind-color",
+"deepmind-text",
+"deepseek",
+"deepseek-color",
+"deepseek-text",
+"devin",
+"devin-color",
+"devin-text",
+"dify",
+"dify-color",
+"dify-text",
+"doc2x",
+"doc2x-color",
+"doc2x-text",
+"docsearch",
+"docsearch-color",
+"docsearch-text",
+"dolphin",
+"dolphin-text",
+"doubao",
+"doubao-color",
+"doubao-text",
+"dreammachine",
+"dreammachine-text",
+"elevenlabs",
+"elevenlabs-text",
+"elevenx",
+"elevenx-text",
+"essentialai",
+"essentialai-color",
+"essentialai-text",
+"exa",
+"exa-color",
+"exa-text",
+"fal",
+"fal-color",
+"fal-text",
+"fastgpt",
+"fastgpt-color",
+"fastgpt-text",
+"featherless",
+"featherless-color",
+"featherless-text",
+"figma",
+"figma-color",
+"figma-text",
+"fireworks",
+"fireworks-color",
+"fireworks-text",
+"fishaudio",
+"fishaudio-text",
+"flora",
+"flora-text",
+"flowith",
+"flowith-text",
+"flux",
+"flux-text",
+"friendli",
+"friendli-text",
+"gemini",
+"gemini-color",
+"gemini-text",
+"geminicli",
+"geminicli-color",
+"geminicli-text",
+"gemma",
+"gemma-color",
+"gemma-text",
+"giteeai",
+"giteeai-text",
+"github",
+"github-text",
+"githubcopilot",
+"githubcopilot-text",
+"glama",
+"glama-text",
+"glif",
+"glif-text",
+"glmv",
+"glmv-color",
+"glmv-text",
+"google",
+"google-brand",
+"google-brand-color",
+"google-color",
+"googlecloud",
+"googlecloud-brand",
+"googlecloud-brand-color",
+"googlecloud-color",
+"goose",
+"goose-text",
+"gradio",
+"gradio-color",
+"gradio-text",
+"greptile",
+"greptile-color",
+"greptile-text",
+"grok",
+"grok-text",
+"groq",
+"groq-text",
+"hailuo",
+"hailuo-color",
+"hailuo-text",
+"haiper",
+"haiper-text",
+"hedra",
+"hedra-text",
+"hermesagent",
+"hermesagent-text",
+"higress",
+"higress-color",
+"higress-text",
+"huawei",
+"huawei-color",
+"huawei-text",
+"huawei-text-cn",
+"huaweicloud",
+"huaweicloud-color",
+"huaweicloud-text",
+"huaweicloud-text-cn",
+"huggingface",
+"huggingface-color",
+"huggingface-text",
+"hunyuan",
+"hunyuan-color",
+"hunyuan-text",
+"hyperbolic",
+"hyperbolic-color",
+"hyperbolic-text",
+"ibm",
+"ibm-text",
+"ideogram",
+"ideogram-text",
+"iflytekcloud",
+"iflytekcloud-color",
+"iflytekcloud-text",
+"inception",
+"inception-text",
+"inference",
+"inference-text",
+"infermatic",
+"infermatic-color",
+"infermatic-text",
+"infinigence",
+"infinigence-color",
+"infinigence-text",
+"infinigence-text-cn",
+"inflection",
+"inflection-text",
+"internlm",
+"internlm-color",
+"internlm-text",
+"jimeng",
+"jimeng-color",
+"jimeng-text",
+"jina",
+"jina-text",
+"junie",
+"junie-color",
+"junie-text",
+"kilocode",
+"kilocode-text",
+"kimi",
+"kimi-color",
+"kimi-text",
+"kiro",
+"kiro-color",
+"kiro-text",
+"kling",
+"kling-color",
+"kling-text",
+"kluster",
+"kluster-color",
+"kluster-text",
+"kolors",
+"kolors-color",
+"kolors-text",
+"krea",
+"krea-text",
+"kwaikat",
+"kwaikat-text",
+"kwaikat-text-color",
+"kwaipilot",
+"kwaipilot-color",
+"kwaipilot-text",
+"lambda",
+"lambda-text",
+"langchain",
+"langchain-color",
+"langchain-text",
+"langfuse",
+"langfuse-color",
+"langfuse-text",
+"langgraph",
+"langgraph-color",
+"langgraph-text",
+"langsmith",
+"langsmith-color",
+"langsmith-text",
+"leptonai",
+"leptonai-color",
+"leptonai-text",
+"lg",
+"lg-color",
+"lg-text",
+"lightricks",
+"lightricks-text",
+"liquid",
+"liquid-text",
+"livekit",
+"livekit-color",
+"livekit-text",
+"llamaindex",
+"llamaindex-color",
+"llamaindex-text",
+"llava",
+"llava-color",
+"llava-text",
+"llmapi",
+"llmapi-color",
+"llmapi-text",
+"lmstudio",
+"lmstudio-text",
+"lobehub",
+"lobehub-color",
+"lobehub-text",
+"longcat",
+"longcat-color",
+"longcat-text",
+"lovable",
+"lovable-color",
+"lovable-text",
+"lovart",
+"lovart-text",
+"luma",
+"luma-color",
+"luma-text",
+"magic",
+"magic-text",
+"make",
+"make-color",
+"make-text",
+"manus",
+"manus-text",
+"mastra",
+"mastra-text",
+"mcp",
+"mcp-text",
+"mcpso",
+"mcpso-color",
+"mcpso-text",
+"menlo",
+"menlo-color",
+"menlo-text",
+"meshy",
+"meshy-color",
+"meshy-text",
+"meta",
+"meta-brand",
+"meta-brand-color",
+"meta-color",
+"meta-text",
+"metaai",
+"metaai-color",
+"metaai-text",
+"metagpt",
+"metagpt-text",
+"microsoft",
+"microsoft-color",
+"microsoft-text",
+"midjourney",
+"midjourney-text",
+"minimax",
+"minimax-color",
+"minimax-text",
+"mistral",
+"mistral-color",
+"mistral-text",
+"modelscope",
+"modelscope-color",
+"modelscope-text",
+"monica",
+"monica-color",
+"monica-text",
+"moonshot",
+"moonshot-text",
+"morph",
+"morph-color",
+"morph-text",
+"moxt",
+"moxt-color",
+"moxt-text",
+"myshell",
+"myshell-color",
+"myshell-text",
+"n8n",
+"n8n-color",
+"n8n-text",
+"nanobanana",
+"nanobanana-color",
+"nanobanana-text",
+"nebius",
+"nebius-text",
+"newapi",
+"newapi-color",
+"newapi-text",
+"notebooklm",
+"notebooklm-text",
+"notion",
+"notion-text",
+"nousresearch",
+"nousresearch-text",
+"nova",
+"nova-color",
+"nova-text",
+"novelai",
+"novelai-text",
+"novita",
+"novita-color",
+"novita-text",
+"nplcloud",
+"nplcloud-color",
+"nplcloud-text",
+"nvidia",
+"nvidia-color",
+"nvidia-text",
+"obsidian",
+"obsidian-color",
+"obsidian-text",
+"ollama",
+"ollama-text",
+"openai",
+"openai-text",
+"openchat",
+"openchat-color",
+"openchat-text",
+"openclaw",
+"openclaw-color",
+"openclaw-text",
+"opencode",
+"opencode-text",
+"openhands",
+"openhands-color",
+"openhands-text",
+"openhuman",
+"openhuman-text",
+"openrouter",
+"openrouter-text",
+"openwebui",
+"openwebui-text",
+"palm",
+"palm-color",
+"palm-text",
+"parasail",
+"parasail-text",
+"perplexity",
+"perplexity-color",
+"perplexity-text",
+"phidata",
+"phidata-color",
+"phidata-text",
+"phind",
+"phind-text",
+"pika",
+"pika-text",
+"pixverse",
+"pixverse-color",
+"pixverse-text",
+"player2",
+"player2-color",
+"player2-text",
+"poe",
+"poe-color",
+"poe-text",
+"pollinations",
+"pollinations-text",
+"ppio",
+"ppio-color",
+"ppio-text",
+"ppio-text-cn",
+"prunaai",
+"prunaai-color",
+"prunaai-text",
+"pydanticai",
+"pydanticai-color",
+"pydanticai-text",
+"qingyan",
+"qingyan-color",
+"qingyan-text",
+"qiniu",
+"qiniu-color",
+"qiniu-text",
+"qoder",
+"qoder-color",
+"qoder-text",
+"qwen",
+"qwen-color",
+"qwen-text",
+"railway",
+"railway-text",
+"recraft",
+"recraft-text",
+"relace",
+"relace-text",
+"replicate",
+"replicate-brand",
+"replicate-text",
+"replit",
+"replit-color",
+"replit-text",
+"reve",
+"reve-text",
+"roocode",
+"roocode-text",
+"rsshub",
+"rsshub-color",
+"rsshub-text",
+"runway",
+"runway-text",
+"rwkv",
+"rwkv-color",
+"rwkv-text",
+"sambanova",
+"sambanova-color",
+"sambanova-text",
+"search1api",
+"search1api-color",
+"search1api-text",
+"searchapi",
+"searchapi-text",
+"sensenova",
+"sensenova-brand",
+"sensenova-brand-color",
+"sensenova-color",
+"sensenova-text",
+"siliconcloud",
+"siliconcloud-color",
+"siliconcloud-text",
+"sillytavern",
+"sillytavern-color",
+"sillytavern-text",
+"skywork",
+"skywork-color",
+"skywork-text",
+"slock",
+"slock-text",
+"smithery",
+"smithery-color",
+"smithery-text",
+"snowflake",
+"snowflake-color",
+"snowflake-text",
+"sophnet",
+"sophnet-color",
+"sophnet-text",
+"sora",
+"sora-color",
+"sora-text",
+"spark",
+"spark-color",
+"spark-text",
+"speedai",
+"speedai-color",
+"speedai-text",
+"stability",
+"stability-brand",
+"stability-brand-color",
+"stability-color",
+"stability-text",
+"statecloud",
+"statecloud-color",
+"statecloud-text",
+"stepfun",
+"stepfun-color",
+"stepfun-text",
+"straico",
+"straico-color",
+"straico-text",
+"streamlake",
+"streamlake-color",
+"streamlake-text",
+"submodel",
+"submodel-color",
+"submodel-text",
+"suno",
+"suno-text",
+"sync",
+"sync-text",
+"targon",
+"targon-color",
+"targon-text",
+"tavily",
+"tavily-color",
+"tavily-text",
+"tencent",
+"tencent-brand",
+"tencent-brand-color",
+"tencent-color",
+"tencent-text",
+"tencent-text-cn",
+"tencentcloud",
+"tencentcloud-color",
+"tencentcloud-text",
+"tiangong",
+"tiangong-color",
+"tiangong-text",
+"tii",
+"tii-color",
+"tii-text",
+"together",
+"together-brand",
+"together-brand-color",
+"together-color",
+"together-text",
+"topazlabs",
+"topazlabs-text",
+"trae",
+"trae-color",
+"trae-text",
+"tripo",
+"tripo-color",
+"tripo-text",
+"turix",
+"turix-text",
+"udio",
+"udio-color",
+"udio-text",
+"unstructured",
+"unstructured-color",
+"unstructured-text",
+"upstage",
+"upstage-color",
+"upstage-text",
+"v0",
+"vectorizerai",
+"vectorizerai-text",
+"venice",
+"venice-color",
+"venice-text",
+"vercel",
+"vercel-text",
+"vertexai",
+"vertexai-color",
+"vertexai-text",
+"vidu",
+"vidu-color",
+"vidu-text",
+"viggle",
+"viggle-text",
+"vllm",
+"vllm-color",
+"vllm-text",
+"volcengine",
+"volcengine-color",
+"volcengine-text",
+"voyage",
+"voyage-color",
+"voyage-text",
+"wenxin",
+"wenxin-color",
+"wenxin-text",
+"windsurf",
+"windsurf-text",
+"workersai",
+"workersai-color",
+"workersai-text",
+"worldrouter",
+"worldrouter-text",
+"xai",
+"xai-text",
+"xiaomimimo",
+"xiaomimimo-text",
+"xinference",
+"xinference-color",
+"xinference-text",
+"xpay",
+"xpay-color",
+"xpay-text",
+"xuanyuan",
+"xuanyuan-color",
+"xuanyuan-text",
+"yandex",
+"yandex-text",
+"yi",
+"yi-color",
+"yi-text",
+"youmind",
+"youmind-text",
+"yuanbao",
+"yuanbao-color",
+"yuanbao-text",
+"zai",
+"zai-text",
+"zapier",
+"zapier-color",
+"zapier-text",
+"zeabur",
+"zeabur-color",
+"zeabur-text",
+"zencoder",
+"zencoder-color",
+"zencoder-text",
+"zenmux",
+"zenmux-text",
+"zeroone",
+"zeroone-color",
+"zeroone-text",
+"zhipu",
+"zhipu-color",
+"zhipu-text"
+]
+}
\ No newline at end of file
diff --git a/skills/drawio-skill/references/shapes.md b/skills/drawio-skill/references/shapes.md
index d943ec3..0759788 100644
--- a/skills/drawio-skill/references/shapes.md
+++ b/skills/drawio-skill/references/shapes.md
@@ -45,6 +45,30 @@ BPMN, ER, electrical, P&ID, mockup/wireframe, flowchart, network, and the
general/basic sets. The bundled index (`data/shape-index.json.gz`) is the
upstream draw.io shape data — see `data/SHAPE-INDEX-NOTICE.md` for attribution.
+## AI / LLM brand logos
+
+draw.io's bundled libraries have **no** modern AI/LLM brand logos, so an "LLM app
+architecture" otherwise renders as generic boxes. `scripts/aiicons.py` resolves a
+brand name (OpenAI, Claude, Gemini, Mistral, Llama, HuggingFace, Ollama,
+LangChain, …321 brands) to a draw.io `image` style backed by the
+[lobe-icons](https://github.com/lobehub/lobe-icons) set (MIT).
+
+```bash
+python3 <this-skill-dir>/scripts/aiicons.py "claude" --json # CDN reference
+python3 <this-skill-dir>/scripts/aiicons.py "openai" --embed # self-contained
+python3 <this-skill-dir>/scripts/aiicons.py --list # all brands
+```
+
+- Picks the `-color` variant when it exists, else the mono logo (e.g. OpenAI is
+ mono-only). Returns a square `image` style; use the reported `--size` (default
+ 48) for both width and height.
+- **Default references the icon by CDN URL** — the SVG lives on unpkg, not in
+ this repo, so **draw.io needs network access when the diagram is rendered or
+ opened**; an offline export draws a blank box. Pass `--embed` to fetch the SVG
+ once and inline it as a data URI (portable, renders offline, larger XML).
+- Logos are trademarks of their respective owners, referenced for identification
+ only — the same basis on which draw.io ships AWS/Azure icons.
+
## Cheatsheet — hand-writable styles
These are stable enough to write without searching. Combine with `whiteSpace=wrap;html=1;`.
diff --git a/skills/drawio-skill/scripts/aiicons.py b/skills/drawio-skill/scripts/aiicons.py
new file mode 100644
index 0000000..3e6f5c5
--- /dev/null
+++ b/skills/drawio-skill/scripts/aiicons.py
@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""Find AI / LLM brand logos (OpenAI, Claude, Gemini, ...) as draw.io styles.
+
+draw.io's bundled shape libraries have no modern AI/LLM brand logos, so an
+"LLM app architecture" renders as generic boxes. This resolves a brand name to a
+draw.io `image` style that references the matching SVG from the lobe-icons set
+(https://github.com/lobehub/lobe-icons, MIT) on the unpkg CDN.
+
+ python3 aiicons.py "openai"
+ python3 aiicons.py "claude" --json
+ python3 aiicons.py "langchain" --variant mono --size 48
+
+The icon is referenced by URL (data/lobe-icons.json carries only the name list,
+not the assets), so draw.io fetches it from the CDN when the diagram is rendered
+or opened. That means **network is required at render time**; an offline export
+draws a blank box. Use --embed to fetch the SVG once and inline it as a
+self-contained data URI instead (portable, no network at render time).
+
+The logos are trademarks of their respective owners and are referenced here for
+identification only — the same basis on which draw.io ships AWS/Azure icons.
+
+Usage: python3 aiicons.py <query> [--limit N] [--variant color|mono|text]
+ [--size PX] [--embed] [--json] [--list]
+"""
+import argparse
+import base64
+import json
+import os
+import re
+import sys
+import urllib.request
+
+MANIFEST = os.path.join(os.path.dirname(__file__), "..", "data", "lobe-icons.json")
+STYLE = ("shape=image;html=1;imageAspect=0;aspect=fixed;"
+ "verticalLabelPosition=bottom;verticalAlign=top;image=")
+_VARIANT = re.compile(r"-(color|text)$")
+
+
+def families(icons):
+ """base brand name -> set of its variant filenames (without .svg)."""
+ fam = {}
+ for name in icons:
+ base = _VARIANT.sub("", name)
+ fam.setdefault(base, set()).add(name)
+ return fam
+
+
+def squish(s):
+ return re.sub(r"[^a-z0-9]", "", s.lower())
+
+
+def search(fam, query, limit):
+ """Rank brand bases against the query (squished + per-token matching)."""
+ q = squish(query)
+ tokens = [t for t in re.findall(r"[a-z0-9]+", query.lower()) if t]
+ scored = {}
+ for base in fam:
+ b = squish(base)
+ s = 0
+ if q and q == b:
+ s = 100
+ elif q and b.startswith(q):
+ s = 60
+ elif q and q in b:
+ s = 40
+ for t in tokens:
+ if t == b:
+ s = max(s, 90)
+ elif len(t) >= 3 and b.startswith(t):
+ s = max(s, 50)
+ elif len(t) >= 3 and t in b:
+ s = max(s, 30)
+ if s:
+ scored[base] = s
+ return sorted(scored, key=lambda base: (-scored[base], base))[:limit]
+
+
+def pick_variant(base, variants, prefer):
+ order = {"color": ["-color", "", "-text"],
+ "mono": ["", "-color", "-text"],
+ "text": ["-text", "-color", ""]}[prefer]
+ for suffix in order:
+ cand = base + suffix
+ if cand in variants:
+ return cand
+ return next(iter(sorted(variants)), None)
+
+
+def main():
+ ap = argparse.ArgumentParser(description="Find AI/LLM brand logos as draw.io styles (lobe-icons via CDN).")
+ ap.add_argument("query", nargs="?", help='brand name, e.g. "openai" or "claude"')
+ ap.add_argument("--limit", type=int, default=8)
+ ap.add_argument("--variant", choices=["color", "mono", "text"], default="color")
+ ap.add_argument("--size", type=int, default=48, help="cell width/height in px (icons are square)")
+ ap.add_argument("--embed", action="store_true",
+ help="inline the SVG as a data URI (fetches it now; portable, no network at render time)")
+ ap.add_argument("--json", action="store_true")
+ ap.add_argument("--list", action="store_true", help="list all brand names and exit")
+ args = ap.parse_args()
+
+ if not os.path.exists(MANIFEST):
+ sys.exit(f"error: manifest not found at {MANIFEST}")
+ manifest = json.load(open(MANIFEST, encoding="utf-8"))
+ fam = families(manifest["icons"])
+ cdn = manifest["cdn"]
+
+ if args.list:
+ for base in sorted(fam):
+ print(base)
+ return
+ if not args.query:
+ ap.error("a query is required (or use --list)")
+
+ matches = search(fam, args.query, args.limit)
+ if not matches:
+ sys.exit(f"no AI/LLM brand matched {args.query!r} — try --list, or use a generic shape")
+
+ results = []
+ for base in matches:
+ file = pick_variant(base, fam[base], args.variant)
+ url = f"{cdn}{file}.svg"
+ if args.embed:
+ try:
+ svg = urllib.request.urlopen(url, timeout=15).read()
+ except Exception as exc: # noqa: BLE001 - report and skip
+ sys.stderr.write(f"warning: could not fetch {url} ({exc})\n")
+ continue
+ # Rewrite the 1em intrinsic size so draw.io scales the inlined SVG.
+ svg = svg.replace(b'width="1em"', b'width="24"').replace(b'height="1em"', b'height="24"')
+ image = "data:image/svg+xml," + base64.b64encode(svg).decode()
+ else:
+ image = url
+ results.append({"brand": base, "file": file, "w": args.size, "h": args.size,
+ "style": STYLE + image})
+
+ if args.json:
+ print(json.dumps(results, indent=2, ensure_ascii=False))
+ else:
+ for r in results:
+ shown = r["style"] if len(r["style"]) < 160 else r["style"][:157] + "..."
+ print(f"{r['brand']} ({r['file']}, {r['w']}x{r['h']})\n {shown}")
+
+
+if __name__ == "__main__":
+ main()