5分钟装好 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
obsidian-skills 是一套教 AI 代理读写 Obsidian 的 Agent Skills，覆盖 Obsidian Markdown、Bases、JSON Canvas 与 Obsidian CLI。照做之后，你的 agent 能直接创建笔记、搜索库内容、生成数据库视图和画布文件。本文覆盖安装前检查、三步部署走查与最小验证。
安装前检查：4 项前置条件
- 🧰 已安装兼容 Agent Skills 规范的 agent：Claude Code、Codex 或 Open Code 任一即可
- 已安装 Obsidian，并创建好一个 vault（仅 CLI 技能需要）
- 终端可访问你的 vault 根目录或用户主目录
- 若改用
npx skills安装路线，还需 Node.js 环境
部署走查：克隆挂载三步走
- 克隆仓库：执行
git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills。本地目录里应看到skills/下 5 个技能子目录，每个都带一份SKILL.md。 - 按 agent 放置：对照下表选择你使用的 agent，把对应内容复制到目标路径。
- 重启 agent：重启后技能被自动发现，Open Code 必须重启才生效。
| Agent | 目标路径 | 放入内容 |
|---|---|---|
| Claude Code | vault 根目录下的.claude/ | 仓库内容（skills/目录与 README） |
| Codex | ~/.codex/skills/ | 仅skills/目录 |
| Open Code | ~/.opencode/skills/obsidian-skills/ | 整个仓库，而非内层skills/ |
最小验证：确认技能真的被加载
- 建一条笔记：让 agent「新建一篇叫 Test 的笔记，里面加一个 callout」。成功的样子：生成的
.md使用> [!note]这类 Obsidian 专属语法，而不是普通 Markdown。 - 跑一次 CLI 搜索：在 Obsidian 打开的状态下执行
obsidian search query="test" limit=5，返回结果里应包含刚创建的笔记。 - 生成一个画布：让 agent 建一张简单思维导图的
.canvas文件，在 Obsidian 中打开能正常显示节点与连线。
三步全部通过，说明 agent 已经「认识」你的 Obsidian 库。
高频坑：提前避开
| 坑 | 现象 | 原因 | 规避方法 |
|---|---|---|---|
Open Code 只拷内层skills/ | 技能不被识别 | 自动发现需要完整目录层级 | 整仓克隆，不要手动挑目录 |
| Obsidian 没打开 | obsidian-cli 命令失败 | CLI 与运行中的 Obsidian 实例交互 | 先打开 vault 再执行命令 |
| Claude Code 放错位置 | agent 无视技能 | 应放在 vault 根目录的.claude/里 | 严格按走查表放置 |
| 安装后未重启 | 新技能不生效 | agent 只在启动时扫描技能目录 | 装完立即重启 agent |
跑起来之后能做什么
- 笔记生产线：用 obsidian-markdown 批量生成带属性、wikilink、callout、嵌入的笔记，细则见 skills/obsidian-markdown/
- 数据与可视化：让 agent 建带过滤器和公式的
.base数据库视图，或画.canvas画布思维导图 - 库操作与插件开发：用 obsidian-cli 搜索内容、管理任务、设置属性，还能调
dev:errors查插件报错、截图验证 UI
下一步，先让 agent 按标签整理你的 vault 笔记，并用 Bases 生成一张表格视图，看看效果。
【免费下载链接】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），仅供参考
