3 步让 obsidian-skills 自动打理你的知识库:Obsidian 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
你的 Obsidian 库是不是也这样:笔记攒了几百条,旧链接指不到地方,标签东一个西一个;想把上周的会议记录统一补上属性、互相挂上链接,只能一篇一篇点开手改。这类"不难但很耗时"的活,恰恰最适合交给 AI 代劳——前提是这个 AI 得真正懂 Obsidian 的文件格式。obsidian-skills 就是干这件事的:一组开箱即用的 Agent 技能包,教 Claude Code、Codex、OpenCode 等 AI 助手读懂并安全地操作你的库。
一句话读懂 obsidian-skills 是什么 📦
它不是一个插件,也不是一个应用,而是一堆按规范写好的"技能说明书"。装进你的 AI 工具后,助手就学会了 Obsidian 的方言:怎么写内部链接、怎么建数据库视图、怎么画画布文件、怎么调命令行。换句话说,你负责提需求,格式正确性这些细节交给它,而且它对库的操作都落在真实文件上,改完在 Obsidian 里一打开就能验证。
五件事,它替你干
1. 帮你把笔记写得符合 Obsidian 语法
痛点:普通 Markdown 助手分不清[[笔记]]内部链接和普通链接的区别,也常把属性区(frontmatter)、标注块写错,导致库里的链接和元数据悄悄坏掉。装上 markdown 技能模块 后,AI 会主动用 Obsidian 风味语法写笔记:库内链接走 wikilink(笔记改名后链接自动跟着走),高亮信息用标注块,标题、别名、标签等属性按规范放进头部。附带几份参考文档(如 CALLOUTS.md)列全了每种标注的写法,AI 照着执行,出错概率很低。
2. 帮你把散落的笔记变成数据库
痛点:想把"所有带 status 属性且未归档的笔记"汇成一张表,手工筛选根本做不了。obsidian-bases 模块 让 AI 掌握 Bases——Obsidian 自带的数据库功能(.base文件,可按属性筛选笔记并生成表格、卡片、列表等视图)。你可以直接说"给我一张阅读清单表,只显示标记为在读的书,按收藏时间排序",它会连筛选条件、计算公式和视图布局一起写好,你打开文件即可看到结果。
3. 帮你画出看得见的知识图谱
痛点:概念之间的关系只在脑子里,画成图又要手动拖节点、连线条。json-canvas 模块 教会 AI 读写 JSON Canvas 文件(.canvas,Obsidian 的画布格式,由节点和连接线组成)。"把我这三篇读书笔记画成一张关系图,中间留好位置"这类需求,它会生成带节点、连线的画布文件,连节点 ID 是否冲突、位置会不会重叠都会检查,你只管在画布上欣赏和微调。
4. 帮你对整个库做批量操作
痛点:批量改属性、查任务、创建笔记,一条一条点太慢。obsidian-cli 模块 让 AI 通过官方 Obsidian 命令行工具直接对话正在运行的 Obsidian:搜索库内容、创建或修改笔记、管理任务与属性,甚至支持插件开发时的重载、截图和调试。批量重命名、按条件筛选后统一补标签这类"体力活",说一句就能跑完。
5. 帮你把网页"洗"成干净笔记
痛点:让 AI 读一篇长网页做摘录,广告、导航栏全被当成正文,又费 token 又影响判断。defuddle 模块 的作用就是提取网页正文、剥掉杂乱元素,输出干净的 Markdown,再交给 AI 摘要或存进库里,整个过程更快也更准。
5 分钟装好 obsidian-skills 🚀
整个安装就一条命令(也可用 git clone 把仓库下载到本地再按平台放置):
npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills装完后按你用的 AI 工具做一步激活,路径各不相同:
- Claude Code:把仓库内容放进 Obsidian 库根目录(或你日常使用 Claude Code 的目录)下的
.claude文件夹; - Codex:把
skills/目录拷到 Codex 的技能路径(一般是~/.codex/skills); - OpenCode:把整个仓库克隆到
~/.opencode/skills/,它会按目录结构自动发现技能,重启即可用。
放好之后重启你的 AI 工具,然后直接用人话下指令就行,比如:
"帮我给上周的会议笔记统一补上日期属性,并建立相互链接。" "把这几篇读书笔记做成一张 Canvas 关系图。"
新手落地的 3 个建议 ✍️
- 先派小活再派大活:第一次让它只改三五篇笔记或建一张小视图,确认它对语法的理解没跑偏,再放开做批量任务。
- 把流程固化成习惯句式:收集素材 → 清洗整理 → 建立关联 → 检查格式,每次按同一套顺序下指令,AI 的产出会更稳定,你也容易发现它哪一步没做对。
- 改完一定去 Obsidian 里验证:AI 写的是真实文件,打开阅读视图扫一眼链接、标注和表格视图是否正常,比反复追问它"你写对了吗"高效得多。
适合谁,以及现在就能做什么
如果你的库已经积累到"手动整理开始疼"的规模——写作爱好者、研究者、项目管理者都算在内——这套技能值得花十分钟装一下。它不收钱、不锁库、不改变你现有的任何习惯,只是让 AI 从"会聊天"升级到"会干活"。现在就挑一个拖了很久的整理任务(补属性、建视图、画关系图任选其一),把它完整地说给 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辅助生成(AIGC),仅供参考