3种方法装好 obsidian-skills：让 AI 助手快速操作 Obsidian 的完整指南

梅俐筝

574人浏览 · 2026-08-30 11:04:36

梅俐筝 · 2026-08-30 11:04:36 发布

3种方法装好 obsidian-skills：让 AI 助手快速操作 Obsidian 的完整指南

【免费下载链接】obsidian-skills Agent 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 助手只会写普通 Markdown，wikilink、标注、Bases、画布这些它都不认识，产出经常打不开。obsidian-skills 就是来解决这个问题的：一套免费的开源技能包，教会 AI 智能体使用 Obsidian CLI 和开源格式，包括 Markdown、Bases、JSON Canvas。本文带你看懂它是什么，并对比 3 种安装方法，选一条路径装好。

📦 项目速览：这套技能包教会 AI 什么

obsidian-skills 遵循 Agent Skills 规范编写，任何兼容该规范的 AI 助手都能直接加载，目前明确支持 Claude Code、Codex 和 OpenCode。装完后，你的 AI 会获得 5 项能力：

Obsidian 风格 Markdown：创建和编辑 .md 笔记，正确处理 wikilink [[笔记]]、嵌入 ![[嵌入]]、标注 callout、frontmatter 属性
Obsidian Bases：创建和编辑 .base 文件，定义筛选器、公式，配置表格、卡片、列表、地图视图
JSON Canvas：创建和编辑 .canvas 文件，管理节点、连接边和分组
Obsidian CLI：通过命令行操作正在运行的 Obsidian，读写笔记、搜索、批量管理属性，也支持插件和主题开发
Defuddle：从网页提取干净的 Markdown，去掉导航和广告，节省 token

✅ 安装前要确认的 3 件事

动手前先核对：

一个支持 Agent Skills 的 AI 助手，比如 Claude Code、Codex 或 OpenCode
一个现有的 Obsidian 库，技能包最终服务于操作这个库
看安装方式选工具：npx 方式需要 Node.js + npm；手动方式需要 git

🧭 三种安装方式对比：难度与维护成本一览

方案	难度	适合人群	维护成本
A. 插件市场	低	新手、Claude Code 用户	自动更新，基本免维护
B. npx 命令行	中	习惯终端的开发者	重新执行命令即可更新
C. 手动安装	偏高	想完全控制目录结构的进阶用户	需手动克隆同步

想一键搞定就选 A；助手不支持插件市场就选 B 或 C。

🔧 分步实操：按方案装好技能包

方案 A：通过插件市场安装

在助手里执行两条命令即可完成，无需离开 AI 助手：

/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

操作步骤：打开 Claude Code 等兼容助手，按顺序粘贴上面两条命令，然后重启助手，技能包即生效。

方案 B：用 npx 一键安装

先确认 Node.js 和 npm 可用，再在终端执行下面的命令：

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

命令会自动拉取仓库并配置全部技能，完成后重启 AI 助手即可。

方案 C：手动安装（完全控制）

无论哪种助手，第一步都是把仓库克隆到本地：

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

克隆完成后，按你使用的助手分支操作：

Claude Code：把仓库内容放入 Obsidian 库根目录下的 .claude 文件夹；如果 Claude Code 在其他目录工作，就放进那个目录的 .claude。

Codex：把 skills/ 目录复制到 Codex 技能路径（通常是 ~/.codex/skills）：

cp -r obsidian-skills/skills ~/.codex/skills

OpenCode：直接把整个仓库克隆进技能目录。注意不要只复制里面的 skills/ 文件夹，目录结构必须是 ~/.opencode/skills/obsidian-skills/skills/<技能名>/SKILL.md：

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

OpenCode 会自动发现 ~/.opencode/skills/ 下所有 SKILL.md，不需要改任何配置文件，重启即可。

🔍 装完必做的 3 项验证 + 常见问题速查

验证技能生效，按顺序做三件事：

重启 AI 助手，这一步所有方案都逃不掉
让 AI 建一篇测试笔记，要求加一个 callout 和 wikilink，到 Obsidian 阅读视图确认语法渲染正常，说明 Markdown 技能可用
让 AI 建一个简单 .base 文件，能正常打开视图说明核心技能全部就位

遇到问题的速查：

技能未加载：检查路径，SKILL.md 必须在 <技能名>/SKILL.md 位置；OpenCode 尤其注意必须克隆完整仓库，只放 skills/ 目录不会生效
defuddle 不可用：这个技能依赖 Defuddle CLI，先执行 npm install -g defuddle 安装
AI 没用上技能：每个技能都描述了触发条件，描述任务时带上相关词汇（如 wikilink、Bases、.canvas 文件），更容易触发对应技能

💡 装好之后能落地的 4 个技巧

网页内容先清洗再喂给 AI：读在线文章时让 AI 用 defuddle parse <url> --md 提取干净 Markdown，比直接抓页面省 token。
批量操作走 CLI：obsidian-cli 技能要求 Obsidian 保持打开，适合追加日志笔记、批量设置属性、统计标签这类重复动作。
让 AI 按标准流程建 Bases：建文件 → 写 filters → 定义 formulas → 配置视图 → 验证。打开 .base 报 YAML 错误时，先查引号：含冒号的字符串要加引号，公式里带双引号就整体用单引号包裹。
Canvas 文件改完要验证：提醒 AI 检查边引用的节点必须存在、所有 ID 不能重复，否则画布会打不开。