先弄清楚这包装的是什么

obsidian-skills 不是插件、也不是 Obsidian 的新功能，而是一套写给 agent 看的说明文件：每个技能是一个目录，里面一份 SKILL.md，告诉 agent「做这类事该按什么规矩来」。它遵循 Agent Skills 规范，所以 Claude Code、Codex、OpenCode 这些支持该规范的客户端都能用。仓库由 Obsidian 作者 kepano 维护，MIT 许可，目前约 4.9 万 star。

六个技能可以按「你让 agent 干哪种活」来记：

  • obsidian-markdown —— 写和改 Obsidian 风格 Markdown：wikilink、嵌入、callout、properties 这些 Obsidian 专有写法；
  • obsidian-bases —— 生成和编辑 .base 文件，含视图、过滤器、公式与汇总；
  • json-canvas —— 生成和编辑 .canvas 白板，含节点、连线与分组；
  • obsidian-cli —— 通过 Obsidian CLI 操作笔记库，也覆盖插件与主题开发；
  • defuddle —— 用 Defuddle 把网页抓成干净 Markdown，去掉干扰内容省 token；
  • knap —— 用 Knap 从 JSON / CSV 数据渲染 Markdown 模板，支持批量生成文件。

第一步：选一种安装方式

三种方式效果一样，按平时的使用习惯挑一个就行。

如果客户端带插件市场命令（例如 Claude Code）：

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

如果习惯用 npx skills 统一管理技能：

# SSH 方式
npx skills add git@github.com:kepano/obsidian-skills.git

# 或者走 HTTPS
npx skills add https://github.com/kepano/obsidian-skills

如果只想手动放，按客户端各自的技能目录来：

  • Claude Code：把仓库内容放进笔记库根目录（或你实际用 Claude Code 打开的那个目录）下的 .claude 文件夹；
  • Codex：把 skills/ 目录拷进 Codex 的技能路径，通常是 ~/.codex/skills；
  • OpenCode：直接把整个仓库 clone 到 ~/.opencode/skills/obsidian-skills，然后重启 OpenCode。
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills
OpenCode 这条路有个官方特别提醒：不要只复制仓库里内层的 skills/ 文件夹，要克隆整个仓库。OpenCode 是按 ~/.opencode/skills/obsidian-skills/skills/<技能名>/SKILL.md 这个层级去找 SKILL.md 的，层级错了就发现不了；反过来，只要层级对，不需要改 opencode.json。

第二步：确认 agent 真的加载了

装完之后最容易踩的坑是「以为装上了」。OpenCode 要重启才会发现新技能，Claude Code 与 Codex 也建议重开会话。验证方式很直接——在会话里问一句：

# 在 agent 会话里问
你能用哪些 Obsidian 相关的技能？它们分别负责什么？

真正加载成功的表现，是它能说出具体技能名（例如 obsidian-bases 负责 .base 文件），而不是笼统地回一句「我可以帮你操作 Obsidian」。说不出来，就回去查 SKILL.md 的路径层级对不对。

第三步：从一件小事开始，别一上来就让它改整个库

这类技能改变的是「agent 知不知道 Obsidian 的写法」，而不是「agent 会不会读写文件」。第一次用建议挑一件可回滚的小活，比如「把这篇笔记里的裸链接改成 wikilink」，或者「给这个文件夹生成一个按标签分组的 .base 视图」，做完自己打开 Obsidian 确认渲染正常。

  • 先在有版本控制或备份的笔记库里试，确认没问题再放到主力库；
  • 让它动手前先要求「列出你打算改哪些文件、每个文件改什么」，看完再放行；
  • 涉及 .base / .canvas 这类结构化文件时，让它指出改动依据的是哪个技能的哪条规则——对不上就说明技能没生效。

这套东西解决的是「规矩」，不是「能力」

把笔记库交给 agent，真正的失败模式往往不是模型写不出内容，而是它按通用 Markdown 的直觉去写：wikilink 被拆成普通链接、properties 被当成正文、callout 语法写错。obsidian-skills 补的正是这一层规矩；而且它是明文文件，你可以直接读、也可以改——不喜欢某种写法，改 SKILL.md 比在对话里反复纠正更省事。

值得往下看的是这类「格式技能」会不会变成标配。如果各家笔记与文档工具都出一套自己的 SKILL.md，那 agent 能不能直接用你的知识库，比拼的就成了「谁的技能描述得更准确」，而不是谁的模型更强。今天就能做的一件事：拿一个不重要的笔记库，把这 6 个技能装上，让它做上面那件小事，看它是否真按 Obsidian 的规矩来。

本文的安装命令与技能清单依据仓库 README（github.com/kepano/obsidian-skills），适用于 Claude Code、Codex、OpenCode 这类支持 Agent Skills 规范的客户端；star 数取自 GitHub API。Obsidian 自身版本差异与第三方插件不在本文范围内。