Obsidian Viz Skill
Generate Obsidian-compatible visualization files from text descriptions or image inputs.
Processing Flow
Step 0 - Input Type Detection
If user sends an image:
- 1. Load INLINECODE0
- Execute image type recognition and content extraction
- Output structured Markdown summary
- If image contains diagrams, proceed to Step 1
- If image is text/screenshot only, end process
If user provides text description:
- - Proceed directly to Step 1
Step 1 - Tool Selection
Load modules/chart-router.md and select the most appropriate tool based on content type:
- - Excalidraw: Hand-drawn style, architecture diagrams, free layout, concept maps
- Mermaid: Technical documentation, flowcharts, sequence diagrams, state diagrams, ER diagrams
- Canvas: Large knowledge networks, interactive exploration, data visualization
Step 2 - Format Specification Loading
Load the corresponding reference file based on the selected tool:
- -
mermaid → INLINECODE3 - INLINECODE4 → INLINECODE5
- INLINECODE6 → INLINECODE7
Important: Must read the corresponding reference file before generating any content.
Step 3 - Output Format Selection
Standard Format (when user explicitly requests "standard format" or "excalidraw.com"):
- - Mermaid →
.mmd file - Excalidraw →
.excalidraw file - Canvas →
.html file
Obsidian Format (default):
- - Mermaid →
.md file (with mermaid code block) - Excalidraw →
.md file (with Excalidraw JSON) - Canvas →
.canvas file
Step 4 - Generate File
- 1. Strictly follow format specifications in reference file
- Output to INLINECODE14
- Explain to user how to open the file in Obsidian
Usage Instructions
Excalidraw Files
Obsidian Mode (.md):
- - Place in any vault folder
- Obsidian automatically opens in canvas mode
- Requires Excalidraw plugin
Standard Mode (.excalidraw):
- - Can be opened directly at excalidraw.com
- Supports import to any Excalidraw instance
Mermaid Files
Obsidian Mode (.md):
- - Place anywhere in vault
- Renders in normal preview mode
- Obsidian supports Mermaid by default
Standard Mode (.mmd):
- - Can be opened in Mermaid-compatible editors
- Natively supported by GitHub, GitLab, etc.
Canvas Files
Obsidian Mode (.canvas):
- - Place anywhere in vault
- Double-click to interact in Canvas view
- Natively supported by Obsidian
Standard Mode (.html):
- - Open in browser
- Supports interactive exploration
Chart Type Quick Reference
| Need | Recommended Tool | Chart Type |
|---|
| Workflow / CI-CD | Excalidraw or Mermaid | flowchart |
| API calls / Message interaction |
Mermaid | sequenceDiagram |
| Organization / System hierarchy | Excalidraw | hierarchy |
| Concept divergence / Brainstorming | Canvas or Excalidraw | mindmap |
| State machine / Lifecycle | Mermaid | stateDiagram-v2 |
| Project timeline | Excalidraw | timeline |
| A vs B comparison | Excalidraw | comparison |
| Priority matrix | Excalidraw | matrix |
| Large knowledge network | Canvas | free-layout |
| Animation demo | Excalidraw | animation mode |
| Database design | Mermaid | erDiagram |
| Class diagram / Object relationships | Mermaid | classDiagram |
| Project schedule | Mermaid | gantt |
Notes
- 1. Must load reference first: Skipping this step will produce incorrectly formatted files
- Chinese support: All tools natively support Chinese, no escaping needed
- File path: Output files are uniformly placed in
~/.openclaw/workspace/outputs/ directory - Fallback strategy: If primary tool fails, automatically try alternative tool
- Node count limit: For more than 30 nodes, recommend user to split or use Canvas
Obsidian Viz 技能
根据文本描述或图像输入生成兼容 Obsidian 的可视化文件。
处理流程
步骤 0 - 输入类型检测
如果用户发送图像:
- 1. 加载 modules/image-reader.md
- 执行图像类型识别和内容提取
- 输出结构化的 Markdown 摘要
- 如果图像包含图表,继续执行步骤 1
- 如果图像仅为文本/截图,结束流程
如果用户提供文本描述:
步骤 1 - 工具选择
加载 modules/chart-router.md,根据内容类型选择最合适的工具:
- - Excalidraw:手绘风格、架构图、自由布局、概念图
- Mermaid:技术文档、流程图、时序图、状态图、ER 图
- Canvas:大型知识网络、交互式探索、数据可视化
步骤 2 - 格式规范加载
根据所选工具加载对应的参考文件:
- - mermaid → references/mermaid.md
- excalidraw → references/excalidraw.md
- canvas → references/canvas.md
重要:在生成任何内容之前,必须读取对应的参考文件。
步骤 3 - 输出格式选择
标准格式(当用户明确要求标准格式或excalidraw.com时):
- - Mermaid → .mmd 文件
- Excalidraw → .excalidraw 文件
- Canvas → .html 文件
Obsidian 格式(默认):
- - Mermaid → .md 文件(包含 mermaid 代码块)
- Excalidraw → .md 文件(包含 Excalidraw JSON)
- Canvas → .canvas 文件
步骤 4 - 生成文件
- 1. 严格遵循参考文件中的格式规范
- 输出到 ~/.openclaw/workspace/outputs/<文件名>.<扩展名>
- 向用户说明如何在 Obsidian 中打开该文件
使用说明
Excalidraw 文件
Obsidian 模式(.md):
- - 放置在任何库文件夹中
- Obsidian 自动以画布模式打开
- 需要 Excalidraw 插件
标准模式(.excalidraw):
- - 可直接在 excalidraw.com 打开
- 支持导入到任何 Excalidraw 实例
Mermaid 文件
Obsidian 模式(.md):
- - 放置在库中任意位置
- 在普通预览模式下渲染
- Obsidian 默认支持 Mermaid
标准模式(.mmd):
- - 可在兼容 Mermaid 的编辑器中打开
- GitHub、GitLab 等原生支持
Canvas 文件
Obsidian 模式(.canvas):
- - 放置在库中任意位置
- 双击在 Canvas 视图中交互
- Obsidian 原生支持
标准模式(.html):
图表类型快速参考
| 需求 | 推荐工具 | 图表类型 |
|---|
| 工作流 / CI-CD | Excalidraw 或 Mermaid | flowchart |
| API 调用 / 消息交互 |
Mermaid | sequenceDiagram |
| 组织 / 系统层级 | Excalidraw | hierarchy |
| 概念发散 / 头脑风暴 | Canvas 或 Excalidraw | mindmap |
| 状态机 / 生命周期 | Mermaid | stateDiagram-v2 |
| 项目时间线 | Excalidraw | timeline |
| A vs B 对比 | Excalidraw | comparison |
| 优先级矩阵 | Excalidraw | matrix |
| 大型知识网络 | Canvas | free-layout |
| 动画演示 | Excalidraw | animation mode |
| 数据库设计 | Mermaid | erDiagram |
| 类图 / 对象关系 | Mermaid | classDiagram |
| 项目进度计划 | Mermaid | gantt |
注意事项
- 1. 必须先加载参考文件:跳过此步骤将生成格式错误的文件
- 中文支持:所有工具原生支持中文,无需转义
- 文件路径:输出文件统一放置在 ~/.openclaw/workspace/outputs/ 目录下
- 降级策略:如果首选工具失败,自动尝试替代工具
- 节点数量限制:超过 30 个节点时,建议用户拆分或使用 Canvas