obsidian-skills 完整指南:教 AI 直接操作你的笔记库,十分钟开启笔记自动化
【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills
如果你想让 AI 真正操作 Obsidian——写会议纪要、清洗网页内容、生成动态表格和思维画布,obsidian-skills 是一个相当直接的开源项目:它把 Obsidian 的用法打包成 AI 可直接加载的 Agent Skills,覆盖 CLI、Markdown 语法、Bases、Canvas 和网页提取五大块。装上之后,AI 就按 Obsidian 的规则写文件,笔记自动化从"AI 帮你生成一段文字"变成"AI 直接操作你的库"。这篇文章按"能力全景 + 任务实战"的顺序,带你完整跑一遍。
一张能力矩阵看懂 obsidian-skills 的 5 个 Obsidian AI 技能
所有技能都放在 skills/ 目录下,每个技能一份独立的SKILL.md说明文件,AI 会根据你的任务自动去读。可以粗分成两大类:
内容录入——把东西写进库
| 技能 | 管什么 | 典型产物 |
|---|---|---|
| obsidian-cli | 通过 CLI 操作运行中的 Obsidian | 建笔记、搜索、改属性、写日记、管任务 |
| obsidian-markdown | Obsidian 风味 Markdown 语法 | .md笔记:双链、嵌入、提示框、属性、公式、Mermaid |
| defuddle | Defuddle CLI | 从网页抽取干净的 Markdown 正文 |
知识组织——把库里的东西整理出来
| 技能 | 管什么 | 典型产物 |
|---|---|---|
| obsidian-bases | Bases 数据库视图 | .base文件:过滤器、公式、表格/卡片/地图视图 |
| json-canvas | JSON Canvas 公开规范 | .canvas画布:节点、连线、分组容器 |
这套技能本质是写给 AI 的"规则手册":它不替代 Obsidian 本身,而是保证 AI 写出来的.md、.base、.canvas语法正确,打开就能渲染。
十分钟安装 obsidian-skills:三种 AI 工具加载方式
按你用的 AI 工具挑一种即可,装完自动发现,不需要改任何配置文件:
- Obsidian 插件市场:先执行
/plugin marketplace add kepano/obsidian-skills,再执行/plugin install obsidian@obsidian-skills; - npx 一行命令:
npx skills add <仓库地址>; - 手动放置:Claude Code 用户把仓库内容放进 Vault 根目录的
.claude文件夹;Codex 用户把skills/目录拷贝到~/.codex/skills/;OpenCode 用户必须克隆整个仓库到~/.opencode/skills/obsidian-skills,只拷内层 skills 文件夹会破坏目录结构:
git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills
这些技能遵循 Agent Skills 开放规范,所以 Claude Code、Codex、Open Code 等主流代理都能加载,重启对应工具后就能直接对话使用。
AI 自动会议纪要:一条命令把结构化笔记写进库
问题:开完会你只想说一句"把纪要存进 Obsidian",剩下的格式、标签、双链都由 AI 完成,而不是你手动新建再排版。
obsidian-cli 能直接和运行中的 Obsidian 实例对话。让 AI 执行:
obsidian create name="周会纪要" content="# 结论\n\n> [!important]\n> 下个版本聚焦导入导出能力\n\n## 待办\n- [ ] 周四前出设计方案\n\n相关:[[版本规划]]" obsidian search query="竞品分析" limit=20 obsidian property:set name="status" value="已归档" file="周会纪要"结果:笔记自动生成,带 callout 强调框、待办清单和双链,阅读视图直接渲染;同一个 CLI 还能全库搜索、批量改属性、往日记追加任务(daily:append)。命令记不全就先跑obsidian help,命令列表永远是最新的。
底层由 obsidian-markdown 技能负责"语法把关":它告诉 AI 双链和 Markdown 链接各自的适用场景、如何嵌入 PDF 页和图片、callout 怎么折叠、LaTeX 公式与 Mermaid 图怎么写,避免产出渲染不出来的半成品。
一条命令清洗网页转 Markdown:defuddle 正文提取
问题:收藏一篇行业报道,全选粘贴进来,导航栏、弹窗、广告位全跟着进库,AI 后续读它还得额外消耗 token。
defuddle 技能让 AI 用 Defuddle CLI 抽正文,一条命令搞定:
defuddle parse https://example.com/report --md -o 行业报告.md defuddle parse https://example.com/article -p title--md指定 Markdown 输出,-o直接把干净正文落成笔记文件,-p可单独抽取标题、描述等元信息。未安装时先npm install -g defuddle。对资讯页、博客、文档站,它比通用抓取工具输出更规整——"收藏一篇网页"从此是一句自然语言的事。
Obsidian Bases 动态表格与 Canvas 画布:让文件自己组织知识
这两块对应"把散落的笔记组织起来",AI 写的都是纯文本文件,打开即生效。
Bases(.base):文件内容就是一段 YAML。你只需要描述需求,比如"给我一张所有带'选题'标签笔记的表",AI 就会生成 filters 段用 and/or/not 组合圈定范围(按标签、文件夹、属性过滤),在 formulas 段定义计算列,再在 views 段输出表格或卡片视图,每列显示什么用 order 指定。Obsidian 里它会显示成一张随笔记实时更新的动态表格,还能用![[某个库.base]]嵌进任何一篇笔记里。完整的过滤器、公式函数和常见报错对照都在 skills/obsidian-bases/SKILL.md,遇到 YAML 引号问题可以当速查表用。
Canvas(.canvas):遵循 JSON Canvas 公开规范,文件核心就是 nodes 和 edges 两个数组。节点分文本、文件、链接、分组容器四种,各带坐标、尺寸、颜色;连线通过 fromNode/toNode 引用节点 id,可加箭头、标签和颜色。AI 把这份 JSON 存成.canvas,在 Obsidian 里打开就是原生画布,想拖想连都随你。讨论时想把思路当场摊到白板上,这就是最快的一条路。
AI 辅助 Obsidian 插件开发:四步调试闭环
如果你自己写 Obsidian 插件或主题,obsidian-cli 里还有一套开发者命令,AI 可以替你跑通"改代码 → 验证"的闭环:
obsidian plugin:reload id=my-plugin obsidian dev:errors obsidian dev:screenshot path=screenshot.png obsidian eval code="app.vault.getFiles().length"改完代码一条命令重载插件,出错了直接读日志,页面截图和 DOM 检查走命令行,eval还能在应用上下文里执行 JavaScript 查看运行状态。AI 从此不只是代你记笔记,也能动你的开发环境。
上手前先看:新手必知的 5 个避坑提醒
- ⚠️ 用 defuddle 抓网页别忘加
--md,不加的话默认输出 HTML; - CLI 命令不必背,先跑
obsidian help,列表始终与当前版本同步; .base公式里含双引号时,用单引号包住整条表达式;日期相减得到的是 Duration,要先取.days再做数值运算;属性可能为空就用if()包一层,公式才不会整体报错;- 编辑
.canvas时,确认每个 fromNode/toNode 都指向真实存在的节点 id,JSON 引号不要写漏; - OpenCode 安装记得克隆整个仓库,只拷
skills/内层文件夹会导致技能无法被发现。
【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考