obsidian-skills 完整教程：让 AI 替你操作 Obsidian

obsidian-skills 完整教程：让 AI 替你操作 Obsidian

【免费下载链接】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 给库里 300 篇笔记批量补标签、修好断链，再按状态汇总出一张任务表——这种事以前只能一条一条点。obsidian-skills 是一套面向 Obsidian 的 Agent 技能包，装好之后一句指令就能把活交出去。它教 Claude Code、Codex、OpenCode 这类 agent 读写 Obsidian 专属格式（Flavored Markdown、Bases、JSON Canvas），还能通过官方 CLI 直接操作库。技能遵循开放的 Agent Skills 规范，技能目录 里的每个 SKILL.md 就是一份 agent 自己会查的手册。

帮谁省下整理笔记的时间

这套技能包的目标用户，是已经在用 AI agent 干活、同时维护 Obsidian 库的人。痛点很集中：标准 Markdown agent 都会写，但 Obsidian 的扩展语法它没见过——[[wikilink]] 内部链接、![[嵌入]]、frontmatter 属性、.base 数据库、.canvas 画布，写出来轻则格式错乱，重则 agent 直接拒绝动手。obsidian-skills 不装插件也不改 Obsidian，只是把五份教材放进 agent 的技能目录，每份 SKILL.md 对应一种格式，语法、易错点、校验步骤齐全。你说"帮我建一个读书清单数据库"，agent 会先查技能，再产出能直接打开的文件。

🗂️ 用这套技能干四类活

按你想完成的事分，五份技能覆盖四类场景。

整理笔记内容

obsidian-markdown 技能覆盖 Obsidian 专属 Markdown 全貌：wikilink 及其到标题、到块级的变体、内容嵌入、callout、frontmatter、隐藏注释、高亮和 LaTeX。agent 建笔记会先写属性、再排版，同库笔记用内部链接关联，外部网址才用普通链接。以前你要背 callout 类型和嵌套标签写法，现在只说"把截止日放进 important callout，补两个标签"，产出在 Obsidian 里直接可用。

搭建笔记数据库

obsidian-bases 技能负责 .base 文件：过滤条件支持 and/or/not 组合，公式能算阅读时长、逾期天数，内置求和、均值、最早最晚等汇总统计。让它把标记 book 的笔记做成阅读清单，过滤、公式、列顺序会一次写全。

绘制知识画布

json-canvas 技能教 agent 写 .canvas：text、file、link、group 四种节点，边可带箭头，ID 必须是 16 位十六进制且全局唯一。这格式手写最容易坏，一个 ID 写错整个画布打不开；技能里带了校验清单，agent 生成完会自查 ID 和连线引用。一句"把这篇论文的论证链画成画布"，产出即可打开。

用命令行操作库

obsidian-cli 技能让 agent 通过 obsidian 命令跟运行中的 Obsidian 通信：读笔记、创建、搜索、设置属性、管理任务，还有插件重载、截图这类调试命令。defuddle 技能管进料：读网页时先剥离广告和导航，输出干净 Markdown，省 token。批量改属性时它跑的命令长这样：

obsidian property:set name="status" value="done" file="My Note"

🚀 三步装好技能包

1. 一条命令安装

npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills

装到 agent 的技能目录，适合 Claude Code 和 Codex。

2. 想手动放置就 clone

git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills

clone 后按下表把文件放到对应位置，路径不对技能不会被发现。

3. 按平台放对位置，重启生效

放好路径后重启 agent 即可。注意 OpenCode 只拷内层 skills/ 会破坏目录结构，必须 clone 整个仓库。

🛠️ 避开三个高频坑

装完不生效：九成是路径问题。OpenCode 要求完整的仓库结构，只复制内层 skills/ 会找不到 SKILL.md；路径修正后重启 agent 再试。

CLI 命令没反应：obsidian 命令依赖运行中的 Obsidian 实例，没开 app 时不工作；多库环境在命令开头加 vault="库名" 指定目标。

.base 文件报 YAML 错误：常见于含冒号的字符串没加引号、公式里的双引号没被单引号包裹；把报错丢给 agent，一般一轮修好。

如果你的平台不支持 Agent Skills 规范，这些技能文件只是不被加载的纯文本——这类场景不适合硬装，换兼容平台，或把 SKILL.md 手动贴给 agent 也能用。

这套技能做的事很单纯：补上 agent 缺的那块格式知识。下次批量补标签、建库、画画布，先丢给 agent 跑一遍，报错再拿回来让它修。

【免费下载链接】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