Skip to content
Back to search

axton-obsidian-visual-skills

MarketplaceWorks with Claude CodeGitHub

Visual Skills Pack for Obsidian: generate Canvas, Excalidraw, and Mermaid diagrams from text with Claude Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/axtonliu-axton-obsidian-visual-skills/badge.svg)](/listings/axtonliu-axton-obsidian-visual-skills)

HTML

<a href="/listings/axtonliu-axton-obsidian-visual-skills"><img src="/api/listings/axtonliu-axton-obsidian-visual-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed - [Obsidian](https://obsidian.md/) with relevant plugins: - [Excalidraw plugin](https://github.com/zsviczian/obsidian-excalidraw-plugin) (for Excalidraw skill)

Option A: Plugin Marketplace (Recommended)

Install via Claude Code's plugin system:

/plugin marketplace add axtonliu/axton-obsidian-visual-skills
/plugin install obsidian-visual-skills

Then restart Claude Code to load the skills.

Option B: Manual Installation

Copy the skill folders to your Claude Code skills directory:

# Clone the repository
git clone https://github.com/axtonliu/axton-obsidian-visual-skills.git

# Copy skills to Claude Code directory
cp -r axton-obsidian-visual-skills/excalidraw-diagram ~/.claude/skills/
cp -r axton-obsidian-visual-skills/mermaid-visualizer ~/.claude/skills/
cp -r axton-obsidian-visual-skills/obsidian-canvas-creator ~/.claude/skills/

Or copy individual skills as needed.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 23 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "axton-obsidian-visual-skills",
  3. "owner": {
  4. "name": "Axton Liu",
  5. "email": "hey@axtonliu.com"
  6. },
  7. "metadata": {
  8. "description": "Visual Skills Pack for Obsidian: generate Canvas, Excalidraw, and Mermaid from text",
  9. "version": "0.1.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "obsidian-visual-skills",
  14. "description": "Generate Canvas, Excalidraw, and Mermaid diagrams in Obsidian",
  15. "source": "./",
  16. "skills": [
  17. "./excalidraw-diagram",
  18. "./mermaid-visualizer",
  19. "./obsidian-canvas-creator"
  20. ]
  21. }
  22. ]
  23. }
README.md · README · 265 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Obsidian Visual Skills Pack
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  3. [![Status: Experimental](https://img.shields.io/badge/Status-Experimental-orange.svg)](#status)
  4. **[中文文档](README_CN.md)**
  5. Visual Skills Pack for Obsidian: generate Canvas, Excalidraw, and Mermaid diagrams from text with Claude Code.
  6. > **Next Step:** Want to turn Skills from demo to asset? Check out [Agent Skills Resource Library](https://www.axtonliu.ai/agent-skills) (includes slides, PDF, diagnostics)
  7. ## Demo
  8. <table>
  9. <tr>
  10. <td align="center"><strong>Excalidraw</strong></td>
  11. <td align="center"><strong>Mermaid</strong></td>
  12. <td align="center"><strong>Canvas</strong></td>
  13. </tr>
  14. <tr>
  15. <td><img src="assets/excalidraw-demo.png" width="280" alt="Excalidraw Demo"></td>
  16. <td><img src="assets/mermaid-demo.png" width="280" alt="Mermaid Demo"></td>
  17. <td><img src="assets/canvas-demo.png" width="280" alt="Canvas Demo"></td>
  18. </tr>
  19. <tr>
  20. <td align="center"><em>Hand-drawn style</em></td>
  21. <td align="center"><em>Hierarchical flowchart</em></td>
  22. <td align="center"><em>Colorful card layout</em></td>
  23. </tr>
  24. </table>
  25. ### Video Demo
  26. [![Watch the demo](https://img.youtube.com/vi/TUJ_3G1cylc/maxresdefault.jpg)](https://youtu.be/TUJ_3G1cylc)
  27. ## Status
  28. > **Status: Experimental**
  29. >
  30. > - This is a public prototype that works for my demos, but does not yet cover all input scales and edge cases.
  31. > - Output quality varies based on model version and input structure; results may fluctuate.
  32. > - My primary focus is demonstrating how tools and systems work together, not maintaining this codebase.
  33. > - If you encounter issues, please submit a reproducible case (input + output file + steps to reproduce).
  34. ## What Are Skills?
  35. Skills are prompt-based extensions for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that give Claude specialized capabilities. Unlike MCP servers that require complex setup, skills are simple markdown files that Claude loads on demand.
  36. ## Included Skills
  37. ### 1. Excalidraw Diagram Generator
  38. Generate hand-drawn style diagrams with three output modes:
  39. | Mode | Output | Use Case |
  40. |------|--------|----------|
  41. | **Obsidian** (default) | `.md` | Open directly in Obsidian |
  42. | **Standard** | `.excalidraw` | Open/edit/share on excalidraw.com |
  43. | **Animated** | `.excalidraw` | Generate animations with [excalidraw-animate](https://dai-shi.github.io/excalidraw-animate/) |
  44. **Supported Diagram Types:**
  45. | Type | Best For |
  46. |------|----------|
  47. | **Flowchart** | Step-by-step processes, workflows, task sequences |
  48. | **Mind Map** | Concept expansion, topic categorization, brainstorming |
  49. | **Hierarchy** | Org charts, content levels, system decomposition |
  50. | **Relationship** | Dependencies, influences, interactions between elements |
  51. | **Comparison** | Side-by-side analysis of approaches or options |
  52. | **Timeline** | Event progression, project milestones, evolution |
  53. | **Matrix** | 2D categorization, priority grids, positioning |
  54. | **Freeform** | Scattered ideas, initial exploration, free-form notes |
  55. **Key Features:**
  56. - Three output modes for different use cases
  57. - Hand-drawn aesthetic with Excalifont (fontFamily: 5)
  58. - Full Chinese text support with proper character handling
  59. - Animation support with customizable element order
  60. **Trigger words:**
  61. - Obsidian: `Excalidraw`, `diagram`, `flowchart`, `mind map`, `画图`, `流程图`
  62. - Standard: `标准Excalidraw`, `standard excalidraw`
  63. - Animated: `Excalidraw动画`, `动画图`, `animate`
  64. ### 2. Mermaid Visualizer
  65. Transform text content into professional Mermaid diagrams optimized for presentations and documentation. Includes built-in syntax error prevention for common pitfalls.
  66. **Supported Diagram Types:**
  67. - **Process Flow** (graph TB/LR) - Workflows, decision trees, AI agent architectures
  68. - **Circular Flow** - Cyclic processes, feedback loops, continuous improvement
  69. - **Comparison Diagram** - Before/after, A vs B analysis, traditional vs modern
  70. - **Mindmap** - Hierarchical concepts, knowledge organization
  71. - **Sequence Diagram** - Component interactions, API calls, message flows
  72. - **State Diagram** - System states, status transitions, lifecycle stages
  73. **Key Features:**
  74. - Built-in syntax error prevention (list conflicts, subgraph naming, special characters)
  75. - Configurable layouts: vertical/horizontal, simple/standard/detailed
  76. - Professional color schemes with semantic meaning
  77. - Compatible with Obsidian, GitHub, and other Mermaid renderers
  78. **Trigger words:** `Mermaid`, `visualize`, `flowchart`, `sequence diagram`, `可视化`
  79. ### 3. Obsidian Canvas Creator
  80. Create interactive Obsidian Canvas (`.canvas`) files with MindMap or freeform layouts. Outputs valid JSON Canvas format that opens directly in Obsidian.
  81. **Layout Modes:**
  82. | Mode | Structure | Best For |
  83. |------|-----------|----------|
  84. | **MindMap** | Radial hierarchy from center | Brainstorming, topic exploration, hierarchical content |
  85. | **Freeform** | Custom positioning, flexible connections | Complex networks, non-hierarchical content, custom arrangements |
  86. **Key Features:**
  87. - Smart node sizing based on content length
  88. - Automatic edge creation with labeled relationships
  89. - Color-coded nodes (6 preset colors + custom hex)
  90. - Proper spacing algorithms to prevent overlap
  91. - Group nodes for visual organization
  92. **Trigger words:** `Canvas`, `mind map`, `visual diagram`, `思维导图`
  93. ## Installation
  94. ### Prerequisites
  95. - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) installed
  96. - [Obsidian](https://obsidian.md/) with relevant plugins:
  97. - [Excalidraw plugin](https://github.com/zsviczian/obsidian-excalidraw-plugin) (for Excalidraw skill)
  98. ### Option A: Plugin Marketplace (Recommended)
  99. Install via Claude Code's plugin system:
  100. ```
  101. /plugin marketplace add axtonliu/axton-obsidian-visual-skills
  102. /plugin install obsidian-visual-skills
  103. ```
  104. Then restart Claude Code to load the skills.
  105. ### Option B: Manual Installation
  106. Copy the skill folders to your Claude Code skills directory:
  107. ```bash
  108. # Clone the repository
  109. git clone https://github.com/axtonliu/axton-obsidian-visual-skills.git
  110. # Copy skills to Claude Code directory
  111. cp -r axton-obsidian-visual-skills/excalidraw-diagram ~/.claude/skills/
  112. cp -r axton-obsidian-visual-skills/mermaid-visualizer ~/.claude/skills/
  113. cp -r axton-obsidian-visual-skills/obsidian-canvas-creator ~/.claude/skills/
  114. ```
  115. Or copy individual skills as needed.
  116. ## Usage
  117. Once installed, Claude Code will automatically use these skills when you ask for visualizations:
  118. ```
  119. # Excalidraw
  120. "Create an Excalidraw flowchart showing the CI/CD pipeline"
  121. "Draw a mind map about machine learning concepts"
  122. "用 Excalidraw 画一个商业模式关系图"
  123. # Mermaid
  124. "Visualize this process as a Mermaid diagram"
  125. "Create a sequence diagram for the API authentication flow"
  126. "把这个工作流程转成 Mermaid 图表"
  127. # Canvas
  128. "Turn this article into an Obsidian Canvas"
  129. "Create a mind map canvas for project planning"
  130. "把这篇文章整理成 Canvas 思维导图"
  131. ```
  132. ## File Structure
  133. ```
  134. axton-obsidian-visual-skills/
  135. ├── excalidraw-diagram/
  136. │ ├── SKILL.md # Main skill definition
  137. │ ├── assets/ # Example outputs
  138. │ └── references/ # Excalidraw JSON schema
  139. ├── mermaid-visualizer/
  140. │ ├── SKILL.md
  141. │ └── references/ # Syntax rules & error prevention
  142. ├── obsidian-canvas-creator/
  143. │ ├── SKILL.md
  144. │ ├── assets/ # Template canvas files
  145. │ └── references/ # Canvas spec & layout algorithms
  146. ├── README.md
  147. ├── README_CN.md
  148. └── LICENSE
  149. ```
  150. ## Troubleshooting
  151. ### Excalidraw: Chinese text not showing as handwriting font
  152. The skill correctly sets `fontFamily: 5` (Excalifont). However, **Excalifont only covers Latin characters** — CJK handwriting font (Xiaolai) is loaded dynamically from the network.
  153. **Why it works for me:** My Chinese text displays in handwriting style because the font loads successfully from Excalidraw.com.
  154. **Why it might not work for you:**
  155. - Offline mode or unstable network connection
  156. - Cannot access Excalidraw.com (firewall, etc.)
  157. **Solutions:**
  158. **Option A (Online):** Ensure your network can access Excalidraw.com
  159. **Option B (Offline):**
  160. 1. Download CJK font files from [Excalidraw GitHub](https://github.com/excalidraw/excalidraw/tree/master/public/fonts)
  161. 2. Place them in your vault's `Excalidraw/CJK Fonts` folder
  162. 3. In Excalidraw plugin settings, enable "Load Chinese fonts from file at startup"
  163. 4. Restart Obsidian (required for settings to take effect)
  164. ## Contributing
  165. Contributions welcome (low-maintenance project):
  166. - Reproducible bug reports (input + output + steps + environment)
  167. - Documentation improvements
  168. - Small PRs (fixes/docs)
  169. > **Note:** Feature requests may not be acted on due to limited maintenance capacity.
  170. ## Acknowledgments
  171. This project builds upon these excellent open-source tools and specifications:
  172. - [Excalidraw](https://excalidraw.com/) - Hand-drawn style whiteboard
  173. - [Mermaid](https://mermaid.js.org/) - Diagram and chart generation
  174. - [JSON Canvas](https://jsoncanvas.org/) - Open file format for infinite canvas (MIT License)
  175. - [Obsidian](https://obsidian.md/) - Knowledge base application
  176. ## License
  177. MIT License - see [LICENSE](LICENSE) for details.
  178. ---
  179. ## Author
  180. **Axton Liu** - AI Educator & Creator
  181. - Website: [axtonliu.ai](https://www.axtonliu.ai)
  182. - YouTube: [@AxtonLiu](https://youtube.com/@AxtonLiu)
  183. - Twitter/X: [@axtonliu](https://twitter.com/axtonliu)
  184. ### Learn More
  185. - [MAPS™ AI Agent Course](https://www.axtonliu.ai/aiagent) - Systematic AI agent skills training
  186. - [Claude Skills: A Systematic Guide](https://www.axtonliu.ai/newsletters/ai-2/posts/claude-agent-skills-maps-framework) - Complete methodology
  187. - [AI Elite Weekly Newsletter](https://www.axtonliu.ai/newsletters/ai-2) - Weekly AI insights
  188. - [Free AI Course](https://www.axtonliu.ai/axton-free-course) - Get started with AI
  189. ---
  190. © AXTONLIU™ & AI 精英学院™ 版权所有

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.