obsidian-skills 安装指南:把 AI 助手接进 Obsidian 的 3 条最短路径
【免费下载链接】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 是一套 Agent Skills(教会 AI 使用特定工具的技能卡片),装进 AI 助手后,它能正确读写 Obsidian 的 Markdown、Bases、JSON Canvas,还能通过 CLI 直接操作你的库。
obsidian-skills 能干什么(30 秒速览)
- 写 Obsidian 风味 Markdown(.md)
- 建 Bases 数据库视图(.base)
- 画 JSON Canvas 画布(.canvas)
- 用 Obsidian CLI 操作库
- 从网页提取干净 Markdown
能力细节和格式规范在 README 和 skills 源码目录 里都能查到。
🚀 30 秒跑通:一条命令装好
机器上有 Node.js(JavaScript 运行环境)的话,在终端跑这一行即可拉取全部 5 个技能:
npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills验证标准:重启助手后问它「Obsidian 里 wikilink 怎么写」,它答出[[笔记名]]而不是标准 Markdown 链接,就是加载成功了。npx 找不到的话说明 Node.js 没装,直接看下面手动方案。
按场景选安装路径
下面三条路径维护成本完全不同,按你使用助手的方式挑一条就行。
Claude Code 插件市场一键装
适合用 Claude Code 且不想碰终端的人,在助手里输入这两条命令:
/plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills验证:重启后问「你有哪些 Obsidian 相关技能」,能列出 5 个就对了。 常见报错:命令被当成普通问题回答,说明客户端不支持插件指令,换手动方案。
手动挂载到库的 .claude 目录
适合想让技能跟着 vault 走、换个地方直接带走的用户。克隆仓库后把技能拷进库根目录的.claude文件夹:
git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills cp -r obsidian-skills/skills/ <你的库路径>/.claude/skills验证:.claude/skills/下能看到 obsidian-markdown 等 5 个目录,且各含一个 SKILL.md。 常见报错:把 skills 又拷进了一层 skills 目录,最终结构应是.claude/skills/<技能名>/SKILL.md。
批量拉取进 Codex/OpenCode 技能目录
适合开发者和多机批量部署,一条命令落到全局技能路径。OpenCode 直接克隆到指定位置:
git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills验证:ls ~/.opencode/skills/obsidian-skills/skills列出 5 个技能目录即可自动发现;Codex 用户先本地克隆,再cp -r skills/ ~/.codex/skills/obsidian-skills。 常见报错:只拷了内层 skills/ 文件夹导致结构断掉,整个仓库要克隆完整。
| 路径 | 门槛 | 耗时 | 适合谁 | 更新方式 |
|---|---|---|---|---|
| 插件市场 | 最低 | 约 1 分钟 | Claude Code 用户 | 随市场自动更新 |
| 手动挂载 | 中 | 约 3 分钟 | 想让技能跟着库走 | 重新克隆覆盖 |
| 全局技能目录 | 略高 | 约 2 分钟 | Codex/OpenCode/批量部署 | 重新克隆覆盖 |
装完第一条指令:让 AI 立刻干活
加载成功后别闲逛,直接丢这两句给助手:
- 「帮我建一条叫『阅读清单』的笔记:顶部加
tags和status属性,正文放 3 个指向已有笔记的 wikilink,开头加一个[!tip]标注。」 - 「生成一个 3 个节点的 .canvas 文件『项目启动』,用箭头按流程连起来。」
第一句能验证 Markdown 技能是否写对了属性和标注;第二句生成后在 Obsidian 里打开,节点和连线正常显示就稳了。
🧯 踩坑速查:AI 助手加载 Obsidian 技能怎么验证
- 助手还是不认技能→ 检查
.claude/skills/<技能名>/下有没有SKILL.md,然后务必重启助手 - 只拷了内层 skills/ 文件夹→ OpenCode 下必挂,要保留
obsidian-skills/skills/<技能名>两级结构 obsidian命令没反应→ CLI 是连运行中的 Obsidian 实例,应用得开着且已加载库- npx 报错找不到→ 没装 Node.js,先跑
node -v确认
📌 往后走
- 5 个技能源码都在 skills/,每个技能自带参考文档,比如 obsidian-markdown 的标注表、obsidian-bases 的函数表
- 喂网页内容前用 defuddle 技能先剥离广告杂讯,能省不少 token
- 开发插件或主题时,obsidian-cli 支持一键重载插件和截图验证,省掉手动点来点去
- 更新就删掉本地副本重新拉一次;市场路径则随市场自动更新
现在重启一下助手,丢一句「帮我建一条带属性和标注的笔记」试试,文件在 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辅助生成(AIGC),仅供参考