Obsidian Skills：让你的 AI Agent 真正学会用 Obsidian

当 AI 编程助手逐渐成为开发者的标配，一个尴尬的现实摆在面前：大多数 Agent 对 Obsidian 的理解，仅停留在”写个 Markdown 文件”的层面。Wikilinks、嵌入引用、Callout 语法、Properties 元数据——这些 Obsidian 用户每天都在用的功能，Agent 却频频出错。

Steph Ango（Obsidian CEO，GitHub ID: kepano）显然意识到了这个问题。他推出了 obsidian-skills 项目，一套遵循 Agent Skills 规范的技能包，专门教 AI Agent 如何正确使用 Obsidian 的全部能力。

什么是 Agent Skills？

Agent Skills 是一个开放规范（agentskills.io），定义了 AI 技能包的标准格式：一个 SKILL.md 文件作为入口，可选搭配 scripts/、references/、assets/ 等目录。任何兼容该规范的 Agent——Claude Code、Codex CLI、OpenCode 等——都能直接加载这些技能。

这意味着：写一次技能，所有 Agent 都能用。

五大核心技能

obsidian-skills 包含五个独立技能，覆盖 Obsidian 的主要使用场景：

1. obsidian-markdown——Obsidian 风味 Markdown

Obsidian 的 Markdown 不是标准 Markdown。双链 [[wikilinks]]、嵌入引用 ![[note]]、Callout 语法 > [!note]、YAML Properties——这些扩展语法让 Agent 经常”翻车”。这个技能教会 Agent 正确生成和处理 Obsidian 风味的 Markdown，包括：

Wikilinks 的创建与引用

嵌入式内容（图片、笔记、PDF）

Callout 块（note、warning、tip 等类型）

Properties（YAML frontmatter 元数据）

其他 Obsidian 专属语法

2. obsidian-bases——结构化数据库

Obsidian Bases 是 Obsidian 1.8+ 引入的杀手级功能，让 Markdown 笔记库拥有了类似 Notion Database 的能力。.base 文件支持视图（表格/卡片/日历）、过滤条件、计算公式和汇总统计。

这个技能教 Agent 创建和编辑 Bases 文件，让你的笔记库真正变成结构化数据库。

3. json-canvas——可视化画布

JSON Canvas 是 Obsidian Canvas 的开放格式（jsoncanvas.org），用 JSON 描述节点、边、分组和连接关系。有了这个技能，Agent 可以程序化地生成思维导图、流程图和知识关联图，直接在 Obsidian 中打开即可交互。

4. obsidian-cli——命令行交互

Obsidian 官方提供了 CLI 工具，支持插件开发、主题开发等操作。这个技能让 Agent 能通过命令行与 Obsidian Vault 交互，实现自动化工作流——比如批量处理笔记、自动生成模板、管理插件等。

5. defuddle——网页净化提取

做研究时，Agent 经常需要从网页中提取有用内容。Defuddle 是 kepano 开发的网页净化工具，能去除广告、导航栏等杂乱元素，只保留核心内容并转为干净的 Markdown。这不仅提高了内容质量，还大幅节省了 Token 消耗。

安装方式

obsidian-skills 支持多种安装方式，适配不同的 Agent 平台：

市场安装（最简单）：

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

npx 安装：

npx skills add git@github.com:kepano/obsidian-skills.git

手动安装：

Claude Code：复制到 Vault 根目录的 .claude 文件夹

Codex CLI：复制到 ~/.codex/skills

OpenCode：克隆到 ~/.opencode/skills/obsidian-skills

为什么这很重要？

obsidian-skills 的意义不仅在于五个具体的技能。它代表了一个趋势：AI Agent 正在从”通用工具”走向”专业助手”。

过去，Agent 处理 Obsidian 笔记就像一个不懂本地语言的外国人——能说几句，但经常词不达意。obsidian-skills 让 Agent 学会了 Obsidian 的”母语”：理解双链、会写 Callout、能创建 Bases 数据库、甚至可以通过 CLI 直接操控 Vault。

更值得注意的是，这些技能遵循开放规范。你给 Claude Code 写的 Obsidian 技能，同样能在 Codex CLI 和 OpenCode 中使用。技能不再绑定特定平台，而是跟着用户走。

实际应用场景

知识管理自动化：Agent 自动整理笔记、创建双链、生成 MOC（内容地图）

研究助手：从网页提取内容（Defuddle）、整理到 Vault、建立关联（Canvas）

数据库驱动：用 Bases 构建 CRM、项目追踪、读书清单等结构化系统

批量操作：通过 CLI 批量重命名、移动、标签化笔记

团队协作：统一团队的笔记规范和模板，Agent 自动检查合规性

写在最后

Obsidian 一直是”以人为中心”的笔记工具，而 obsidian-skills 让 AI 也能优雅地融入这个生态。无论你是重度 Obsidian 用户、AI 编程爱好者，还是正在探索 Agent 工作流的开发者，这个项目都值得一试。

项目地址：github.com/kepano/obsidian-skills

Agent Skills 规范：agentskills.io