obsidian-skills Skill：让 AI 秒懂你的双链笔记库格式

Skill超级捕获手 技术创作者 2026-09-06 10 阅读

Obsidian 官方出品的 Agent Skills 合集，让 Claude Code、Codex、OpenCode 这类 AI 编程工具能真正读懂 Obsidian 特有的文件格式——包括 wikilink、.base 数据库视图、.canvas 可视化画布。无需写一行代码，仅靠 5 个 Markdown 技能文件，AI 就能像熟练用户一样操作你的知识库。这个项目由 Obsidian CEO Steph Ango 亲自编写并在 GitHub 狂揽 47k+ star，是 2026 年 Agent Skills 生态最的现象级项目之一。

功能与原则

该技能集合包含 5 个独立技能，各自对应 Obsidian 生态中的一种开放格式或工具：

  • obsidian-markdown：教 AI 正确书写 Obsidian 风味的 Markdown——wikilinks [[]]、嵌入（embeds）、Callout 提示框、frontmatter 属性等
  • obsidian-bases：操作 .base 文件——Obsidian 的数据库视图，支持过滤器、公式和聚合汇总
  • json-canvas：生成和编辑 .canvas 文件——JSON Canvas 格式的视觉画布，可做节点图、思维导图和流程图
  • obsidian-cli：通过 Obsidian 命令行操作笔记库，支持插件开发、主题调试和 DOM 截图等
  • defuddle：将网页清洗为干净 Markdown，去除广告和导航噪音，节省 AI token 消耗

设计原则：不做 SDK，用纯 Markdown 技能文件替代传统驱动，把”操作手册”直接交给 AI 读取。遵循开放 Agent Skills 规范（agentskills.io），不绑定特定平台，任何兼容规范 的 AI Agent 均可使用。

认可度

  • GitHub Star：约 47,594★（截至 2026-09-05）
  • Forks：3,090+
  • 周增速：持续上榜 GitHub Trending，Twitter/Hacker News 讨论度高
  • 社媒热度：Twitter 上相关推文单条可获 80+ likes，Reddit r/Obsidian/ r/ClaudeAI 均被置顶讨论
  • trending 经历：2026 年 5-9 月多次上榜 GitHub Trending，被多家技术媒体深度解读

链接

GitHub：https://github.com/kepano/obsidian-skills

原作者

Steph Ango（GitHub @kepano），Obsidian CEO & 联合创始人。kepano 是 Obsidian 核心产品负责人，亲自编写了这套技能文件，被社区评价为”工具厂商第一次主动给 Agent 写说明书”。

介绍

Obsidian 是目前最流行的双链笔记工具，wikilinks、Canvas、 Bases 等特性让知识管理能力远超普通 Markdown。但 AI Agent 读取 Obsidian 笔记库时，往往把这些特殊格式当作普通文本处理—— wikilink 被理解成普通文字，.canvas 被当作无法解析的 JSON。

kepano/obsidian-skills 就是来解决这个问题的：CEO 本人亲自写了 5 份”操作手册”（Markdown 技能文件），教 AI 正确理解和使用 Obsidian 的每一种专属格式。仓库完全用 Markdown 写成，零行 Python/TypeScript/JS 代码，却让 AI 能执行从写笔记到管理数据库到画关系图的全套操作。

由于遵循开放 Agent Skills 规范，这套技能不绑定任何 AI 平台。Claude Code、OpenCode、Codex 等任何实现该规范的 Agent 均可安装使用——一次编写，多端通用。

特点

  • CEO 亲自操刀：Obsidian CEO 亲自编写技能文件，格式规范权威，AI 解读准确率最高
  • 零代码实现：全部内容为 Markdown 技能文件，无需 SDK、无需 npm 安装，纯文件驱动
  • 跨平台兼容：遵循 Agent Skills 规范，Claude Code / Codex / OpenCode 均可使用
  • 安装极简：一行命令 npx skills add https://github.com/kepano/obsidian-skills 即可完成安装
  • 覆盖完整：从基础笔记格式到数据库视图、可视化画布、CLI 操作、网页清洗，Obsidian 全生态无死角

使用方法

安装（一行命令）：

npx skills add https://github.com/kepano/obsidian-skills

Claude Code 安装：

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

手动安装（复制到 vault）：
将仓库内容复制到 Obsidian vault 根目录的 .claude/ 文件夹，重启 Claude Code 即可。

OpenCode 安装：

git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

安装完成后，AI 会根据任务类型自动调用对应技能——无需手动指定。

使用场景与人群

适用场景：
– 让 AI 自动整理和归档 Obsidian 笔记库
– AI 辅助构建双链笔记结构（wikilinks 自动生成）
– 通过 .base 数据库视图管理项目任务和知识条目
– 用 .canvas 可视化画布做项目思维导图
– AI 批量从网页抓取内容并清洗导入 Obsidian
– Obsidian 插件和主题的 AI 辅助开发

目标用户：
– Obsidian 重度用户（知识管理、PKM 玩家）
– AI + 笔记工作流搭建者（第二大脑实践者）
– Agent Skills 生态研究者
– 想要让 AI 真正读懂自己笔记格式的效率主义者

输入与输出案例

案例一：AI 写 Obsidian 格式笔记

输入（对 Claude Code 说）：

在 vault 的 projects/ai-workflow.md 里创建一篇笔记，内容包括：用 wikilink 链接到 reference/zettelkasten.md，添加一个 Callout 提示框，内容是”AI 是增强工具，不是替代品”，并在 frontmatter 里加上 tags: [AI, productivity]。

输出（AI 自动生成）：

---
tags:
  - AI
  - productivity
---

# AI Workflow Notes

> [!NOTE]
> AI 是增强工具，不是替代品。

See [[reference/zettelkasten]] for the underlying method.

案例二：AI 操作 .base 数据库

输入：

在当前 vault 创建 projects/baseball/base 文件，创建一个叫”赛季统计”的 Base 视图，包含球员名（text）、打率（number）、全垒打（number）三列，然后插入一条记录：球员”张三”，打率 0.315，全垒打 28。

输出（AI 调用 obsidian-bases 技能后生成 .base 文件）：

{
  "tables": [{
    "name": "赛季统计",
    "columns": [
      {"name": "球员名", "type": "text"},
      {"name": "打率", "type": "number"},
      {"name": "全垒打", "type": "number"}
    ],
    "rows": [
      {"球员名": "张三", "打率": 0.315, "全垒打": 28}
    ]
  }]
}

GitHub：https://github.com/kepano/obsidian-skills

GitHub: https://github.com/kepano/obsidian-skills

评论区

0 条评论

登录后可评论。

Skill超级捕获手 10 阅读