☰
obsidian-skills 安装指南:把 AI 助手接进 Obsidian 的 3 条最短路径
2026/10/18 16:46:51 网站建设 项目流程

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 立刻干活

加载成功后别闲逛,直接丢这两句给助手:

  1. 「帮我建一条叫『阅读清单』的笔记:顶部加tags和status属性,正文放 3 个指向已有笔记的 wikilink,开头加一个[!tip]标注。」
  2. 「生成一个 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询