使用 obsidian-skills 创建可视化笔记

Obsidian CEO @kepano 最近发布了他实现的 obsidian-skills，可以创建和管理 Obsidian 笔记、Canvas 和 Bases（数据库视图）。

本指南介绍如何在 Claude Code 使用 obsidian-skills。当然，obsidian-skills 不只在 CC 中使用，也可以在 Claude.ai 等其他支持 Skills 协议的终端使用。

一、Obsidian Skills 简介

Obsidian Skills 是专门按照 Claude Skills 协议设计的技能包，让 AI 能够创建和编辑符合 Obsidian 规范的文件。

核心功能：

• 📊 JSON Canvas - 创建可视化关系图、思维导图、流程图
• 📝 Obsidian Markdown - 创建带有 Obsidian 特殊语法的笔记
• 🗂️ Obsidian Bases - 创建 Obsidian 动态视图

二、Obsidian Skills 安装

前置条件

1. 安装 Obsidian（免费）
2. 安装 Claude Code CLI
3. 创建一个 Obsidian vault（vault 可以看作 obsidian 文档的仓库）

安装步骤

1. 下载仓库 https://github.com/kepano/obsidian-skills/archive/refs/heads/main.zip

2. 解压 解压后，进入 skills 目录，可以看到三个子目录，代表三个 skills：

   • json-canvas
   • obsidian-bases
   • obsidian-markdown

   然后将这三个目录放到 Claude Code 的 skills 目录下面：

   • ~/.claude/skills/：全局安装，不论在哪个目录启动 claude code 都可以使用这三个 obsidian skills。如果目录不存在，手工创建即可。
   • ./.claude/skills/：项目安装，在当前启动 claude code 的目录下安装，只有当前项目可以使用。如果目录不存在，手工创建即可。

   ⚠️ 注意：不能直接将解压的 obsidian-skills-main 放在 .claude/skills 目录下，否则 cc 无法正常加载这些 skills。

3. 验证安装 在 Claude Code 中询问：现在有哪些 skill？

   

三、Obsidian Skills 使用

示例一：项目规划 Canvas

在 Claude Code 中输入：

/json-canvas 创建一个"项目规划.canvas"，包含：
- 3个阶段：计划、执行、验收
- 每个阶段包含2-3个任务节点
- 使用不同颜色区分阶段
- 添加连接线表示流程

示例二：二战国家关系图 Canvas

在 Claude Code 中输入：

/json-canvas 请联网搜索二战国家关系，创建"二战国家关系.canvas"，展示：
- 轴心国阵营（红色）：德国、意大利、日本及其盟友
- 同盟国阵营（绿色）：英国、美国、苏联、中国等
- 两个阵营之间的对抗关系
- 各国加入时间线

示例三：创建 Markdown 笔记

在 Claude Code 中输入：

/obsidian-markdown 创建"读书笔记模板.md"，包含：
- frontmatter: 标签 #读书 #模板，日期为今天
- 使用 info callout 说明如何使用
- 包含书籍信息字段
- 添加笔记和思考区域

示例四：创建 Bases

第一步：创建数据源笔记

/obsidian-markdown 创建三个项目笔记：
1. "项目A.md" - frontmatter: tags: [项目], status: 进行中, priority: 高
2. "项目B.md" - frontmatter: tags: [项目], status: 计划中, priority: 中
3. "项目C.md" - frontmatter: tags: [项目], status: 已完成, priority: 低

第二步：创建 Base 视图

/obsidian-bases 创建"项目管理.base"，用来展示所有项目：
- 筛选：所有带 #项目 标签的文件
- 字段：项目名称、状态、优先级、更新时间
- 使用表格视图
- 按状态分组
- 按优先级排序

四、打开和使用

打开 Obsidian

1. 下载安装 Obsidian
2. 打开 Obsidian
3. 选择 “打开文件夹作为仓库”（Open folder as vault）
4. 选择包含你的笔记的文件夹

查看 Obsidian Skills 生成的文件

将 Claude Code 利用 Obsidian Skills 生成的文件拖动到 Obsidian 的左侧栏，可以看到生成的 Canvas、Md 笔记和 Base 视图。

五、参考资料

• Obsidian Skills GitHub 仓库
• Claude Code 使用文档
• Claude Skills 文档