obsidian-skills：35,900颗 GitHub Star 背后的产品哲学

obsidian-skills：35,900颗 GitHub Star 背后的产品哲学

副标题：五个 Markdown 文件，凭什么在3个月内获得比大多数开源项目终生都要多的 Star？

一个数字

2026年1月，Steph Ango（GitHub 用户名 kepano）——Obsidian 的 CEO——提交了一个 GitHub 仓库。

仓库名：obsidian-skills。

仓库里，最开始只有5个文件。

没有 npm 包，没有需要运行的服务器，没有复杂的安装流程。

根据仓库元数据，项目在2026年1月创建，在5月最后一次推送，显示出活跃的早期开发状态。它包含的 GitHub 主题标签有 claude、codex、obsidian、opencode 和 skills，反映了其多 Agent 兼容性的焦点。项目已积累了32,974颗 GitHub Star 和2,297次 Fork。 此后，仓库的星数几乎增加了三倍，达到35,900颗以上。

五个 Markdown 文件。35,900颗 Star。

为什么？

这篇文章想回答这个问题——不只是「技术上发生了什么」，而是「它背后是什么产品哲学让这件事成为可能」。

一、它到底是什么

在讨论「为什么」之前，先把「是什么」说清楚。

obsidian-skills 是 Obsidian 官方的 5 个 Agent Skills 集合，由 CEO Steph Ango（kepano）创作，教授 Claude Code 等 AI Agent 如何使用 Obsidian Markdown、Bases 数据库、JSON Canvas、CLI 以及网页内容提取。

用更直白的语言：

这5个文件教 AI Agent 说一种 AI 默认不懂的方言——Obsidian Flavored Markdown（OFM）。

最重要的 Skill 是 obsidian-markdown。标准 Markdown 编辑器写的是 CommonMark。但 Obsidian 有自己的方言——OFM——AI Agent 经常写错其中的特性：Wikilinks（[[Note Name]] 和 [[Note Name|display text]]）；嵌入内容（![[Image.png]] 和 ![[Other Note#Section]]）…… 没有这个 Skill，Claude 可能会写标准 Markdown 链接（[Note Name](note-name.md)），破坏 Obsidian 的图谱视图和反向链接。

这就是「5个文件」能做的事：让 AI 从「几乎对」变成「完全对」。

二、五个文件，各有分工

5个 Skill 分别是：obsidian-markdown——核心 Skill，教 Agent Obsidian 风格的 Markdown：[[wikilinks]]、callouts（> [!note]）、frontmatter/YAML 属性、标签、嵌入语法等所有与标准 Markdown 不同的语法。obsidian-bases——教 Agent 如何创建和管理 Bases——Obsidian 的结构化数据层：基于笔记属性的数据库，带有类型化属性、过滤器、排序和视图。AI 可以自动生成 CRM 表格、Sprint 追踪器或研究数据库。json-canvas——JSON Canvas 格式用于可视化白板。Agent 可以创建节点、边、组和空间布局，Obsidian 将其渲染为可交互的 Canvas。

完整的五个文件：

obsidian-bases 处理 .base 文件，这是 Obsidian 的数据库层。json-canvas 处理用于空间笔记地图的 .canvas 文件。defuddle 在保存之前把网页剥离为干净的 Markdown，通过在内容到达 Claude 之前移除广告、导航栏和页面框架来降低 Token 成本。

三、安装只需一行命令

因为它们遵循开放的 Agent Skills 规范，它们可以与 Claude Code、Codex CLI、Gemini CLI 以及任何其他兼容的 Agent 一起工作——不只限于 Anthropic 的工具。上手只需 Claude Code 里的一行命令。

Bash

# 方式1：通过 Claude Code 安装（推荐）
/plugin marketplace add kepano/obsidian-skills/skills/obsidian-markdown
/plugin marketplace add kepano/obsidian-skills/skills/obsidian-bases
/plugin marketplace add kepano/obsidian-skills/skills/defuddle
# Skills 安装到 .claude/skills/（项目级）或 ~/.claude/skills/（全局）
# 方式2：手动安装（最可控）
git clone https://github.com/kepano/obsidian-skills.git /tmp/obsidian-skills
mkdir -p /path/to/vault/.claude/skills
cp -r /tmp/obsidian-skills/skills/* /path/to/vault/.claude/skills/
# 方式3：为 Codex CLI 安装
cp -r /tmp/obsidian-skills/skills/* ~/.codex/skills/
# 方式4：为 OpenCode 安装
git clone https://github.com/kepano/obsidian-skills.git \
~/.opencode/skills/obsidian-skills
# 注意：必须 clone 整个 repo，不能只 cp skills/ 内部文件夹

安装后，Skills 存放在 ~/.claude/skills/（全局）或 .claude/skills/（项目级）。Claude 只在你的请求与某个 Skill 相关时才加载它——这种叫做「渐进式披露」的设计模式让 Token 成本保持低廉。

安装完成后，测试一下：

text

请在我的 Vault 里创建一篇新的会议笔记，
主题：「2026-06-21 产品评审会」
包含：参与者列表、议程、决策记录，
格式遵循 Obsidian 规范，
链接到 [[01-Projects/当前项目]]。

如果 Claude 输出了正确的 OFM 格式——包含 frontmatter、wikilinks、callouts——那么 Skills 已经在工作了。

四、病毒式传播的真实原因：它解决了「每次都要擦屁股」的问题

Obsidian Skills 之所以病毒式传播，是因为它解决了每一个 Obsidian + AI 用户都会遇到的问题：Claude 会写标准的 Markdown，但它不了解 [[wikilinks]]、callouts、Bases 或 Canvas。你的 AI 生成的笔记看起来差不多对，但每次都需要手动清理。这五个 Skill 文件彻底解决了这个问题——开发者们为此疯狂。

「每次都要手动清理」——这句话精准描述了一个让几十万 Obsidian 用户崩溃的日常体验。

你用 AI 生成笔记，然后发现：

Claude Code 默认不了解 Obsidian 的专有文件格式。当它创建笔记时，可能会破坏 wikilink 语法。当它编辑 .base 文件时，会生成无效的 JSON。当它写 .canvas 文件时，输出在 Obsidian 里打不开。解决方案在2026年1月出现，当时 Kepano（Steph Ango，Obsidian 的 CEO）发布了一套官方的 Claude Code Skills。

在 obsidian-skills 出现之前，解决方案是：

在每次提示里都粘贴一大段 Obsidian 语法说明。

这是笨办法。烦人，重复，而且经常被遗漏。

obsidian-skills 把这个「每次必须重复」的提示，变成了一个「一次安装，永久生效」的 Skill。

这就是为什么大家会疯狂分享它。它消除了一个每天都要经历的小摩擦。

五、让我更感兴趣的：「产品发布者是谁」

35,900颗 Star 本身不是最有趣的事。

有趣的是发布它的人。

当 Steph Ango——Obsidian 的 CEO，也是这款应用「文件高于应用」哲学的设计者——在2026年初发布 kepano/obsidian-skills 时，它悄悄地标志着一个转折点。这是第一次，一个主流生产力工具的创始人官方拥抱了 Agent Skills 规范，并为自己的平台发布了生产级别的 Skills。

这个信号的含义：

Obsidian 不是「被动地」与 AI 兼容。它的创始人在主动地为 AI Agent 铺路。

kepano/obsidian-skills 的意义超越了 Obsidian 用户。Steph Ango 构建官方 Skills 的举动，标志着工具厂商开始认真对待 Agent Skills 作为 AI Agent 集成层的地位。到目前为止，大多数 Skills 是由个人开发者或第三方爱好者编写的。工具创建者发布权威的 Skill 集合改变了方程式。

这不是一个孤立的技术决策。这是一个产品战略的声明：

Obsidian 的未来，是 AI Agent 在文件上工作，而不是 Obsidian 自己变成 AI。

六、这个「小东西」开启了一个生态

在 r/ObsidianMD 上，一个题为「Kepano 发布了 obsidian-skills 仓库——你在构建什么自定义 Skills？」的帖子引发了几十条回复。开发者们分享了自定义实现、首次上手指南，以及把 Vault 变成 AI 管理的学习系统、客户数据库和项目追踪器的工作流。共识是：AI Agent 终于能「真正理解」Vault 了——frontmatter、Bases、Canvas 布局、Obsidian 风格的 Markdown——全部处理正确，没有错误。 驱动因素是：Anthropic 将底层的 Claude Skills 格式移入了开放标准，同样的 SKILL.md 文件现在可以跨 Claude Code、Claude Desktop、Claude API 和任何兼容的 Agent 移植。企业级用户现在有了集中的 Skills 管理，把更大的团队也拉进了这套工作流模式。

还有一个更有趣的衍生项目：

一个叫 obsidian-mind 的项目，预装了 kepano/obsidian-skills，并额外加入了一个自定义 Skill：教 Agent 在读取文件之前、创建笔记之前（检查重复），以及创建笔记之后（找到应该链接到它的相关内容）主动使用语义搜索。

这是 Skills 生态的典型演化路径：官方提供基础 Skills，社区在上面叠加更复杂的工作流。

七、这背后是什么产品哲学？

让我做一个更深层的分析。

obsidian-skills 的成功，不只是「解决了一个痛点」。

它还体现了 Steph Ango 一贯的产品哲学，即一种极度克制的系统思维：

1. 做最小的事，解决真实的问题

5个文件，没有 npm 包，没有服务器，没有账号注册。这不是「功能不够」，这是刻意的克制。解决一个真实的、每天发生的问题，不多做一步。

2. 格式即接口，文件即协议

obsidian-skills 是一组符合 Agent Skills 规范的结构化 SKILL.md 文件。每个 Skill 教会 AI 编码 Agent 如何使用特定的 Obsidian 文件格式或工具。它不是插件或应用，而是开发者和高级用户安装到 Agent 技能目录的源代码包，让 Agent 原生理解 Obsidian 特有的语法和工具。

Markdown 文件是接口。不是代码，不是 API，是人类可读的文件。这是 File over App 哲学的一次完美实践。

3. 一次发布，所有 Agent 受益

仓库包含5个 Skills，每个针对特定的 Obsidian 文件格式或功能。因为它们遵循开放的 Agent Skills 规范，它们可以与 Claude Code、Codex CLI、Gemini CLI 以及任何其他兼容的 Agent 一起工作。

这不是为 Claude 专门定制的。任何实现了 Agent Skills 规范的 Agent 都能用。这是一个做「基础设施」而非「功能」的思维方式。

八、给你的启发：如何用同样的逻辑构建你的 IP

Steph Ango 用5个文件获得了35,900颗 Star。

这不是他运气好。这是他的工作方式的必然结果：

text

找到每天都在发生的小摩擦
↓
用最小可能的解决方案消除它
↓
以文件的形式发布（File over App）
↓
让所有人受益，不依赖特定工具

把这个逻辑应用到你的 IP 建设上：

你作为 FDE / AI 部署工程师，每天在做什么让你觉得「这个事情应该被记录下来」？

那个答案，就是你的下一个开源项目的起点。

一个 FDE Playbook 仓库，一套 DECISIONS.md 模板，一个 RAG 评估框架，一套企业 AI 部署检查清单。

不需要很大。需要精准解决一个真实存在的问题，然后以文件的形式免费分享出去。

结语：一个 CEO 的最小有效行动

在没有投资者压力的情况下，Obsidian 可以保持小团队（18人服务150万+用户），耐心发布功能，让社区通过插件驱动创新，而不是急于把所有东西加进核心产品。团队甚至不知道确切的用户数——「我们太注重隐私了，没有分析工具。」但自举模式也意味着 Obsidian 的 AI 故事可能继续以插件驱动而非平台原生——这是一个战略赌注：社区会构建所需的东西。

obsidian-skills 就是这个赌注的一次完美示范：

CEO 亲自写了5个 Markdown 文件，发布到 GitHub，告诉社区「这是怎么做 Skills」。

然后社区爆了。三个月，35,900颗 Star，几百个基于它的衍生项目。

他做了最小的引导，社区做了剩下的所有工作。

这就是开源 + File over App 哲学组合在 AI 时代的威力。

安装命令：/plugin marketplace add kepano/obsidian-skills/skills/obsidian-markdown
GitHub：github.com/kepano/obsidian-skills