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帮忙整理Obsidian库时,它写出来的往往是标准Markdown:内部链接用错格式、属性块解析失败、Bases文件直接打不开。obsidian-skills是一个开源技能包,教会Claude等AI助手读写Obsidian的核心格式,让它能直接创建和编辑你的笔记、数据库与画布文件。
📦 项目速览:obsidian-skills是什么
obsidian-skills不是一个Obsidian插件,而是一组遵循 Agent Skills 规范的技能文件,覆盖五个技能模块:Obsidian风格Markdown、Bases数据库、JSON Canvas画布、Obsidian CLI交互和网页内容提取。
它教会AI理解Obsidian独有的语法与数据结构,并赋予AI通过命令行与正在运行的Obsidian实例交互的能力。核心理念很简单:不改变你的工作流,而是让AI先学会Obsidian的"方言",再动手干活。它兼容所有支持该规范的Agent,包括Claude Code、Codex和OpenCode。
⚡ 快速安装:一条命令配齐技能
最短路径就两步。第一步,在终端执行:
npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills第二步,重启AI助手让它加载新技能。如果npx方式不方便,也可以直接 git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills 到对应平台的技能目录:Claude Code放进库根的.claude文件夹,OpenCode则必须克隆整个仓库到~/.opencode/skills/。
🧩 五大核心能力:笔记、数据库、画布与CLI
- Obsidian风格Markdown—— 正确处理wikilinks、嵌入、callout和frontmatter属性。你可以让它批量创建会议纪要,自动补上标准化属性,并用
[[笔记名]]链接到相关笔记,而不是写出Obsidian不认的普通链接。 - Bases数据库—— 生成含筛选、公式与多视图的合法 .base 文件(对应 skills/obsidian-bases/ 模块)。你可以让它为读书笔记建一个带进度公式的表格视图,或按状态过滤出所有未完成任务。
- JSON Canvas画布—— 按规范产出节点、连接线和分组的 .canvas 文件。你可以让它把一章读书笔记整理成思维导图,或为项目流程画一张带锚点方向的流程图。
- Obsidian CLI交互—— 通过命令读取、搜索、修改运行中的库。你可以让它把新任务追加到今天的日记:
obsidian daily:append content="- [ ] 新任务",还能顺手统计标签使用次数、查看某篇笔记的反向链接。 - 网页内容提取—— 把网页转成干净的Markdown,去掉广告和导航栏,降低AI处理时的token消耗。你可以让它抓取一篇在线文档并归档进库,只留正文。
🔧 实战工作流:批量整理Obsidian会议纪要
场景一,会议纪要归档。你可以对它说:"把这份会议记录整理成笔记,加上属性和关联链接。"它会先读取内容,创建带frontmatter属性的 .md 文件,用wikilinks连上已有的项目笔记,再在目标笔记里补充反向引用。最终你得到一篇格式统一、链接完整的笔记,在Obsidian里直接渲染,图谱视图里新节点就位。
场景二,建一个Bases视图。你可以对它说:"生成一个.base文件,只显示status为active的笔记,按更新日期排序。"它会写好筛选条件并配好table视图,还会自查YAML引号和公式引用是否合法。最终你得到一个打开即用的数据库视图,之后新增笔记会自动进入这张表。
🚧 新手避坑:四个最常见卡点
- 如果给OpenCode装技能,那么务必克隆整个仓库而不是只复制skills子目录,目录结构不对技能就不会被发现。
- 如果想用obsidian-cli能力,那么Obsidian必须处于打开状态,CLI操作的是运行中的实例,关掉Obsidian命令会失败。
- 如果.base文件报YAML错误,那么优先检查字符串引号,以及引用了未定义公式的表达式,这是最常见的两类原因。
- 如果安装后技能不生效,那么先确认路径放对了再重启AI助手,大多数情况重启即解决。
把重复的格式活交给AI,你只负责内容本身。现在就装上obsidian-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),仅供参考