当 Obsidian CEO 亲自给 Claude Code 写 Skill：obsidian-skills 拆解

一个"元工具"的诞生

想象你在用 Obsidian 记笔记——双链、图谱、Canvas、Bases（数据库视图），这些功能组合起来已经够复杂了。现在你想让 AI 帮你管理这个笔记库，但 Claude Code 打开你的 vault 之后，它根本不知道 .canvas 文件长什么样，也不懂 [[wikilink]] 和普通 Markdown 链接有什么区别。

kepano/obsidian-skills 就是来填这个坑的。它的作者不是别人，正是 Obsidian 的 CEO Steph Ango（网名 kepano）。这不是某个爱好者写的第三方插件，而是 Obsidian 官方亲自下场给 AI Agent 做的"操作手册"。

它到底提供了什么？

五个 Skill，每个对应一个 Obsidian 特有的数据格式或工具：

如果你不知道这些格式有什么特别，可以这样理解：普通 Markdown 是 AI 已经会的"普通话"，而 Obsidian 的 wikilink、Canvas、Bases 是"方言"。AI 不学方言，就会把 [[笔记A]] 当成普通文本而不是链接，把 .canvas 文件当成无法理解的 JSON。

Agent Skills 规范：一个值得注意的趋势

这个项目最值得关注的不是某个具体 Skill，而是它遵循的 Agent Skills 规范。README 里明确写了：

These skills follow the Agent Skills specification so they can be used by any skills-compatible agent, including Claude Code, Codex, and Open Code.

翻译一下：这些 Skill 不绑定 Claude Code。Codex、OpenCode，任何遵循规范的 Agent 都能用同一套 Skill 文件。安装方式不同（Claude Code 放 .claude/，Codex 放 ~/.codex/skills/，OpenCode 放 ~/.opencode/skills/），但 Skill 内容本身是通用的。

这让我想到一个类比：Skill 文件之于 AI Agent，就像驱动程序之于操作系统。以前每个 OS 要自己写驱动，后来有了通用驱动框架。Agent Skills 规范在做类似的事——让"AI 能力包"可以跨 Agent 复用。

为什么是 Obsidian CEO 亲自写？

这个信号比项目本身更重要。

Obsidian 的商业模式一直是卖 Sync 和 Publish 服务，客户端免费本地化。现在 CEO 亲自写 Agent Skills，说明 Obsidian 把"AI 可操作性"当成了基础设施级别的事来投入。

原因不难猜：如果 AI Agent 不能正确读写 Obsidian 的文件格式，用户就会迁移到对 AI 更友好的工具。与其等第三方来做，不如官方定义标准。这和数据库厂商亲自写 ORM 驱动是同一个逻辑——控制接口的人就控制了生态。

Defuddle：一个被低估的 Skill

五个 Skill 里，defuddle 最容易被忽略，但实际价值可能最高。它做的事看起来很简单：从网页提取干净的 Markdown，去掉导航栏、广告、脚本等杂质。

但关键词是"省 token"。

当 Agent 需要读一个网页时，如果直接喂原始 HTML，一个复杂页面可能消耗 20K+ token 在导航栏和脚本上。Defuddle 把有效内容提取出来，可能只需要 2K token。对于按 token 计费、上下文窗口有限的 Agent 来说，这不是锦上添花，是实打实的成本节约。

这和 web-reader skill 做的事类似，但 Defuddle 是 Obsidian 生态原生的，和 Markdown 笔记的格式无缝衔接。

和 Anthropic Skills 的关系

注意到同一天 trending 的还有 anthropics/skills（Anthropic 官方 Skill 仓库）。两个项目在同一天上榜不是巧合——Agent Skills 生态正在快速形成。

区别在于：

• anthropics/skills 是 Anthropic 官方维护的通用 Skill 集合
• kepano/obsidian-skills 是第三方应用（Obsidian）官方维护的专用 Skill

两者关系类似"操作系统自带的标准库"和"应用厂商提供的 SDK"。你需要前者来让 Agent 基本运转，需要后者来让 Agent 操作特定工具。

对开发者的启示

如果你在做工具产品，obsidian-skills 提供了一个清晰的模板：

1. 你的数据格式如果不是标准格式，就需要一个 Skill——否则 AI 只能当它是不认识的文本
2. Skill 要遵循 Agent Skills 规范——不要绑定单一 Agent，让用户有选择权
3. 官方下场比第三方更有说服力——用户信任官方对自家格式的理解

数据

• 仓库：kepano/obsidian-skills
• 今日 +411 stars
• 作者：Steph Ango（Obsidian CEO）
• 规范：agentskills.io/specification
• 许可证：未标注（README 未明确）

Agent Skills 规范的出现，意味着 AI Agent 生态正在从"每个 Agent 各干各的"走向"能力可移植"。Obsidian CEO 亲自下场写 Skill，是应用厂商主动适配 Agent 生态的早期信号。