10 min read

Obsidian 的 10 大 AI Skill,第 1 名安装量居然 37 万!

Source: http://x.com/i/article/2067918354443296768

Obsidian 真正厉害的地方不是能写笔记,而是它可以变成 AI Agent 能读、能搜、能整理、能维护的本地知识库。

很多人用 Obsidian 是这样:

收藏了一堆文章。 写了一堆笔记。 建了一堆文件夹。 最后越用越乱,想找资料还得重新搜索。

但如果你把 AI Agent 接进来再配上合适的 Skill,它就不一样了。

AI 可以帮你:

读笔记 搜资料 建新文档 维护双链 整理 frontmatter 生成日记 做网页剪藏 生成思维导图 管理结构化数据 用命令行维护整个 vault

这篇就给你整理一套 Obsidian 10 大 AI Skill

的实操清单。

每个 Skill 到底解决什么问题?小白应该先装哪个?哪些操作一定要谨慎?

1️⃣ vault-maintainer:知识库维护员

榜单里第 1 名是 vault-maintainer。

它的核心作用是:维护 Obsidian vault 的规范性。

比如:

wikilink 是否规范 frontmatter 是否完整 文件名是否安全 路径是否混乱 笔记是否适合 Obsidian 读取 结构是否容易被 AI 调用

如果你有一个越来越大的知识库,这个 Skill 很有用。

因为 Obsidian 用久了,最容易出现的问题不是“没资料”,而是:

文件名乱。 标签乱。 双链乱。 属性乱。 同一主题重复写了好几篇。

适合人群:

Obsidian 重度用户 知识库玩家 AI Agent 用户 长期写笔记的人 用 Obsidian 管理项目的人

2️⃣ obsidian-vault:日常笔记读写必备

第二个是 obsidian-vault。

它更像 AI Agent 操作 Obsidian 的基础工具。

主要能力是:

读取笔记 搜索笔记 创建笔记 编辑笔记 追加内容 添加 wikilink

它适合日常笔记管理。

比如你可以说:

请在我的 Obsidian vault 里创建一篇新笔记。 标题:AI 内容工作流 内容包括: 1. 什么是 AI 内容工作流 2. 适合哪些人 3. 典型流程 4. 常用工具 5. 后续可补充的问题 请使用 Markdown 格式,并添加合适标签。

或者:

请搜索我的 vault 里所有关于 Claude Code 的笔记, 帮我整理成一个目录索引。

obsidian-vault 解决的是“AI 怎么安全读写我的笔记”。

对小白来说,这是最应该优先理解的 Skill 之一。

因为没有读写能力,后面很多高级玩法都跑不起来。

3️⃣ qmd 语义搜索:比关键词搜索更聪明

第三个是 qmd 语义搜索。

它解决的是一个很常见的问题:

你明明记得自己写过某个内容,但搜关键词就是搜不到。

比如你想找:

“如何用 AI 做知识库”

但原文里写的是:

“本地第二大脑搭建方法”

关键词不一样,传统搜索可能找不到。

qmd 这类语义搜索更适合找“意思相近”的内容。

它通常会结合:

关键词搜索 语义检索 排序重排 本地知识库搜索

适合这些场景:

找旧笔记 搜会议记录 搜研究资料 搜项目文档 搜学习笔记 搜写作素材

4️⃣ clipper-template:网页剪藏模板生成器

很多人搭知识库,第一步就是收藏网页。

但网页剪藏很容易乱:

标题不统一。 来源没记录。 摘要没写。 标签没加。 正文格式混乱。 以后根本不知道为什么收藏它。

clipper-template

的价值是帮你把网页收藏变成统一模板。

比如:

请为网页剪藏生成一个 Obsidian 模板。 模板需要包含: 1. 标题 2. 原文链接 3. 作者/来源 4. 发布时间 5. 收藏时间 6. 核心摘要 7. 关键观点 8. 我的思考 9. 可延伸选题 10. 标签

这样你每次收藏网页,都不是简单丢进仓库,而是自动变成结构化资料。

5️⃣ diary:多项目日记系统

很多人写日记只写情绪。

但如果你做项目、做内容、做学习计划,日记其实可以变成复盘系统。

diary 适合做多项目日记。

比如你可以分成:

AI 工具学习日记 X 增长日记 独立开发日记 内容创作日记 健身复盘日记 读书日记

提示词:

请帮我创建今天的项目日记。 项目:X 增长实战 日期:今天 内容结构: 1. 今天做了什么 2. 数据变化 3. 遇到的问题 4. 学到的经验 5. 明天要做什么 6. 可沉淀成知识库的内容

如果你想长期做个人 IP、内容号、独立项目,这个 Skill 很适合。

6️⃣ obsidian-markdown:让 AI 懂 Obsidian 的 Markdown 规则

Markdown 很多人都会。

但 Obsidian 的 Markdown 有自己的特点。

比如:

wikilink 标签 callout embed frontmatter 属性 内部链接 双链网络

obsidian-markdown

的作用,就是让 AI 更懂 Obsidian 的写法。

比如你可以要求:

请把这篇普通 Markdown 笔记, 改成更适合 Obsidian 的格式。 要求: 1. 增加 YAML frontmatter 2. 增加 tags 3. 增加相关笔记 wikilink 4. 使用 callout 标注重点 5. 保持正文可读性

如果你希望 AI 帮你整理笔记,这个 Skill 很基础。

7️⃣ obsidian-bases:结构化数据库管理

Obsidian Bases 可以理解成一种结构化视图。

它适合管理:

项目库 书籍库 课程库 工具库 客户资料 文章选题 任务清单 研究资料

比如你有一个 AI 工具库,可以让 AI 帮你设计字段:

请帮我为 AI 工具库设计一个 Obsidian Bases 结构。 字段包括: 1. 工具名称 2. 官网 3. 类型 4. 适合人群 5. 是否免费 6. 使用场景 7. 我的评分 8. 相关文章 9. 状态:待测试 / 已测试 / 推荐 / 不推荐

如果你做工具测评、项目管理、选题库,这个 Skill 很适合。

8️⃣ json-canvas:可视化白板 / 思维导图

Obsidian 的 Canvas 很适合做可视化关系图。

比如:

知识地图 产品流程图 文章结构图 项目规划图 学习路线图 选题关系图 人物关系图

json-canvas

可以帮 AI 创建和编辑 .canvas 文件。

比如:

请基于我的 10 篇 AI Agent 笔记, 生成一个 Obsidian Canvas 知识图谱。 要求: 1. 中心节点是 AI Agent 2. 周围分成:工具、工作流、案例、风险、学习路线 3. 每个节点链接到对应笔记 4. 节点之间标出关系

如果你做学习路线、课程设计、项目规划,这个 Skill 很实用。

9️⃣ defuddle:网页内容提取去广告

很多网页内容很脏。

有广告。 有导航。 有推荐内容。 有弹窗。 有一堆无关信息。

直接让 AI 读取,容易浪费 token,也容易污染总结结果。

defuddle 的作用是把网页提取成干净内容。

适合:

读博客 读文档 读教程 读文章 做网页剪藏 提取干净 Markdown

提示词:

请用 defuddle 提取这个网页的正文内容, 去掉广告、导航和无关信息, 并保存为 Markdown 格式。 保存后请帮我生成: 1. 核心摘要 2. 关键观点 3. 可执行动作 4. 适合加入哪些知识库主题

🔟 obsidian-cli:命令行管理 vault

最后一个是 obsidian-cli。

它更适合进阶用户。

可以用于:

管理 vault 查找笔记 创建笔记 处理任务 维护属性 开发插件 调试主题 执行命令行操作

小白可以先不用急着上手,但要知道它的价值: 当你的知识库越来越大,命令行管理会比手动点来点去更高效。

比如:

请通过 Obsidian CLI 帮我检查 vault 状态。 要求: 1. 列出最近 7 天修改过的笔记 2. 找出没有标签的笔记 3. 找出没有 frontmatter 的笔记 4. 生成一份维护报告 5. 不要直接修改文件

注意:

命令行操作风险更高。 涉及删除、移动、覆盖,一定要先让 AI 给计划,再确认执行。

小白先装哪 3 个?🧭

如果你刚开始,不建议一口气装 10 个。

先从这 3 个开始:

1. obsidian-vault

解决日常读写问题。

2. obsidian-markdown

让 AI 写出符合 Obsidian 习惯的笔记。

3. defuddle 或 clipper-template

如果你经常收藏网页,优先装网页清洗和剪藏模板。

等你知识库大了,再上:

qmd 语义搜索 vault-maintainer obsidian-bases json-canvas obsidian-cli

Skill 不是越多越好,先解决读写、格式、剪藏这三个高频问题。

怎么安装?给一个最稳步骤

如果你用的是 kepano 的 Obsidian Skills,可以用官方推荐的方式安装。

常见方式是:npx skills add https://github.com/kepano/obsidian-skills 或者使用 Git SSH:npx skills add [email protected]:kepano/obsidian-skills.git

但要注意:

不同 Skill 来源不同。 有些在 kepano 仓库。 有些在 NousResearch / Hermes Agent。 有些来自 OpenClaw 或其他生态。

所以不要看到一个安装命令,就以为 10 个都来自同一个仓库。

更稳的做法是:

  1. 先确认 Skill 来源
  2. 看 README 和 SKILL.md
  3. 看它会不会执行 shell 命令
  4. 看它会不会改文件
  5. 先在测试 vault 里试
  6. 没问题再用到正式 vault

这类 Skill 适合哪些人?

✅ Obsidian 用户

已经在用 Obsidian,但笔记越来越乱。

✅ Claude Code / Codex / Cursor 用户

想让 Agent 不只是写代码,也能管理知识库。

✅ 自媒体创作者

需要管理选题、素材、网页剪藏、文章输出。

✅ 研究生 / 学生

需要整理论文、课程笔记、研究资料。

✅ 独立开发者

需要管理产品想法、技术文档、用户反馈、项目日志。

✅ 知识管理玩家

想把 Obsidian 变成 AI 可操作的第二大脑。

必须注意的 5 个坑

坑一:不要直接在正式库里测试

先建一个测试 vault。

把几篇假笔记放进去,确认 Skill 行为正常再用到正式库。

坑二:不要让 AI 直接批量删除文件

删除、移动、重命名,一定要人工确认。

坑三:不要乱装来源不明的 Skill

Skill 本质上是在教 Agent 怎么做事。 如果来源不可信,可能带来数据和权限风险。

坑四:不要把敏感资料随便交给 Agent

公司文件、客户信息、合同、财务数据、个人隐私,先脱敏再处理。

坑五:不要迷信安装量

安装量高,只说明关注度高,不代表一定适合你。

最后总结

这 10 个 Obsidian AI Skill,可以这样理解:

vault-maintainer:维护知识库规范

obsidian-vault:读写搜索笔记

qmd:语义搜索知识库

clipper-template:网页剪藏模板

diary:多项目日记系统

obsidian-markdown:Obsidian 标准 Markdown

obsidian-bases:结构化数据库

json-canvas:白板和思维导图

defuddle:网页内容提取去广告

obsidian-cli:命令行管理 vault

Obsidian 是知识库的地基,AI Skill 是让 Agent 正确施工的工具箱。

图像