Obsidian 的 Claude Skills:Steph Ango 的官方智能体集成
Obsidian CEO Steph Ango 为 Obsidian 构建了官方 Claude Skills——了解 kepano/obsidian-skills 如何让 AI 智能体编辑知识库、创建画布和使用 Obsidian CLI。

当 Steph Ango——Obsidian 的 CEO、应用"文件优先于应用"理念的设计者——在 2026 年初在 GitHub 上发布 kepano/obsidian-skills 时,这悄然标志着一个转折点。这是第一次有主要生产力工具的创造者官方拥抱 Agent Skills 规范并为自己的平台发布生产质量的 skills。
结果:12,900+ 星,以及 AI 智能体终于可以像人类专家一样导航 Obsidian 知识库。
kepano/obsidian-skills 包含什么
仓库包含五个 skills,每个针对特定的 Obsidian 文件格式或能力:
| Skill | 文件类型 | 教 Claude 什么 |
|---|---|---|
obsidian-markdown | .md | Obsidian 风味 Markdown——Wikilinks、callouts、Dataview、标签 |
obsidian-bases | .base | Obsidian Bases(知识库上的数据库视图) |
json-canvas | .canvas | JSON Canvas 用于空间思维导图和流程图 |
obsidian-cli | CLI 命令 | obsidian:// URI 协议和本地 REST API |
defuddle | Web → Markdown | 将网页清洗为干净的 Markdown 后保存 |
obsidian-markdown Skill 实战
最重要的 skill 是 obsidian-markdown。标准 Markdown 编辑器编写 CommonMark。但 Obsidian 有自己的方言——Obsidian 风味 Markdown(OFM)——原版 AI 智能体会搞错的功能:
- Wikilinks:
[[笔记名称]]和[[笔记名称|显示文本]] - 嵌入内容:
![[Image.png]]和![[Other Note#Section]] - Callouts:
> [!NOTE]/> [!WARNING]/> [!TIP] - 标签:行内
#tag和 frontmatter 中 - Dataview 内联字段:
field:: value
没有 skill 时,Claude 可能会写标准 Markdown 链接([笔记名称](note-name.md)),这会破坏 Obsidian 的图谱视图和反向链接。有了 skill,Claude 产出原生 OFM。
defuddle Skill:AI 智能体的网页剪藏
defuddle 可以说是集合中最新颖的 skill。它解决了在 Obsidian 中做研究的任何人都知道的摩擦点:网页是嘈杂的。
安装了 defuddle skill 后,您可以要求 Claude:
研究 [URL] 上的论文并将干净的摘要保存到我的知识库中
Research/Papers/YYYY-MM-DD-paper-title.md
obsidian-bases Skill:AI 驱动的数据库视图
Obsidian Bases 于 2025 年发布,将每个知识库变成了轻量级数据库。obsidian-bases skill 教 Claude .base 文件格式。
json-canvas Skill:思维导图和架构图
JSON Canvas 是无限画布视觉笔记的开放格式。json-canvas skill 教 Claude 这种格式,实现智能体画布创建。
obsidian-cli Skill:自动化知识库操作
Obsidian 暴露了 URI 协议(obsidian://)和完整的 HTTP API。obsidian-cli skill 教 Claude 两种接口。
为什么这超越了 Obsidian 的意义
kepano/obsidian-skills 的意义超越了 Obsidian 用户。Steph Ango 构建官方 skills 表明工具供应商正在认真对待 Agent Skills 作为 AI 智能体的集成层。
- 正确性保证:obsidian-markdown skill 准确反映 OFM,因为设计 OFM 的人编写了它。
- 维护承诺:当 Obsidian 发布新功能时,skills 会由同一团队更新。
- 为其他工具树立先例:Obsidian 做了的,Expo 也做了(官方
expo/skills仓库),其他人会跟进。
开始使用
要使用 Claude Code 作为您的 Obsidian AI 助手:
- 安装 Claude Code 并在您的知识库目录中打开
- 安装 skills:
/plugin marketplace add kepano/obsidian-skills - 试试您的第一个提示:
"将本周所有会议笔记总结为 Weekly Reviews/2026-W10.md 中的每周摘要笔记"
Claude 会读取您的笔记(经您许可),使用正确的 OFM 格式撰写摘要,并精确保存到您要求的位置。
来源:kepano/obsidian-skills on GitHub · Steph Ango 在 X 上的公告 · Medium 上的 Obsidian Skills 深度解析


