Obsidian Skills · Obsidian Agent Skills套件

这是什么？

Obsidian Skills 是由 Obsidian CEO kepano 亲自维护的 Agent Skills 套件，专为增强 Obsidian 知识管理工具而设计。它包含 5 个 Skill，覆盖 Obsidian 的核心使用场景：Markdown 编辑（OFM 语法）、Base 数据库操作、Canvas 画布交互、CLI 命令行操作、网页内容提取。拥有 42,100 Stars 和 3,000 Forks 的恐怖社区规模。

适合谁：Obsidian 重度用户、使用 AI Agent 进行知识管理的创作者、希望用 Agent 自动化 Obsidian 操作的开发者。

准备工作

• Obsidian 桌面版或 Claude Code/Codex/OpenCode/OpenClaw/Hermes Agent
• Node.js 环境（用于 npx skills 安装）
• 安装方式三选一：
  • Marketplace 一键安装
  • npx skills add git@github.com:kepano/obsidian-skills.git
  • 手动复制到 skills 目录
• 时间预算：5 分钟安装，30 分钟体验全部 5 个 Skill

五步核心流程

第一步：安装 Skill 套件

# 推荐：npx 一键安装
npx skills add git@github.com:kepano/obsidian-skills.git

# 或在 Obsidian 内通过 Marketplace 安装

第二步：obsidian-markdown — OFM 语法编辑

这个 Skill 让你在 Agent 中直接使用 Obsidian Flavored Markdown（OFM）语法：

• Callout 块（> [!note] 等）
• WikiLink（[[页面名]]）
• 嵌入文件（![[文件]]）
• 标签和属性（frontmatter）

触发：$obsidian-markdown

第三步：obsidian-bases — 数据库操作

操作 Obsidian 的 Base 数据库（类似 Notion 数据库）：

• 创建和查询 Base
• 添加/编辑/删除记录
• 过滤和排序
• 关联不同 Base

触发：$obsidian-bases

第四步：json-canvas — Canvas 画布

操作 Obsidian Canvas（无限画布）：

• 创建节点和连线
• 组织视觉思维导图
• 导出 Canvas 为 JSON
• 批量操作节点

触发：$json-canvas

第五步：obsidian-cli + defuddle

• obsidian-cli：通过命令行交互 Obsidian，开发插件、管理 Vault
• defuddle：提取网页内容并转换为 Obsidian 笔记格式

触发：$obsidian-cli / $defuddle

常见踩坑

1. Obsidian 桌面版依赖：部分功能需要 Obsidian 桌面版才能完全使用（如 CLI 操作）
2. Vault 路径：确保 Agent 能访问 Obsidian Vault 的文件路径
3. 插件冲突：如果已有社区插件实现类似功能，可能会冲突
4. Canvas 格式：json-canvas 的 JSON 格式需要与 Obsidian 版本匹配
5. defuddle 提取质量：网页内容提取的质量取决于源网页结构

常见问题 FAQ

Q1: 和 Obsidian 社区插件有什么区别？

A: 社区插件在 Obsidian 内部运行，Obsidian Skills 通过 Agent 外部调用，可以跨应用和自动化工作流。

Q2: 必须使用 Obsidian 桌面版吗？

A: 不是必须的。obsidian-markdown 和 defuddle 可以独立使用，但 obsidian-cli 和 json-canvas 需要 Obsidian 环境。

Q3: 支持哪些 Agent？

A: Claude Code、Codex、OpenCode、OpenClaw、Hermes Agent 等所有支持 Agent Skills 的平台。

Q4: 免费吗？

A: MIT 开源，完全免费。Obsidian 本身个人使用免费。

Q5: 可以在手机上使用吗？

A: 目前主要通过桌面 Agent 使用，移动端 Agent 支持有限。

参考链接

• 官方仓库
• MIT License
• Obsidian 官网
• Agent Skills 文档