obsidian-skills 是什么?

obsidian-skills 是一组用于 Obsidian 的 Agent 技能,由 kepano(Steph Ango,Obsidian 团队)维护。它教会 AI 智能体正确使用 Obsidian 的各类格式与工具:Obsidian 风味 Markdown、Bases(.base 数据库视图)、JSON Canvas(.canvas 白板)、Obsidian CLI,以及 Defuddle(从网页提取干净 Markdown)。这些技能遵循 Agent Skills 规范,因此可被任意兼容该规范的智能体使用,包括 Claude Code、Codex CLI 和 OpenCode。许可为 MIT,约 32,675 stars。

⭐ 33,224 Stars 🍴 2,316 Forks 作者: kepano
来源:README.md(首段、Skills 表);GitHub 仓库元数据(stars=32675、license=MIT) 查看 GitHub 仓库 →

为什么值得关注

Obsidian 是流行的本地优先笔记/知识库工具,拥有大量重度用户;而让 AI 智能体「懂」Obsidian 的专有语法(wikilink、嵌入、callout、properties、Bases、Canvas 等)才能真正帮上忙。这组技能由 Obsidian 官方相关的 kepano 出品、覆盖 Obsidian 的核心格式与 CLI、且跨多种主流智能体可用,权威性与实用性兼具,因而获得高关注。截至数据采集约 32,675 stars。

来源:README.md(Skills 表、跨智能体说明);GitHub 仓库元数据(stars=32675、作者 kepano)

核心功能

Obsidian Markdown

创建和编辑 Obsidian 风味 Markdown(.md),正确处理 wikilink、嵌入、callout、properties 等 Obsidian 专有语法。

来源:README.md(Skills → obsidian-markdown)
Bases 数据库

创建和编辑 Obsidian Bases(.base),含视图、过滤、公式与汇总。

来源:README.md(Skills → obsidian-bases)
JSON Canvas

创建和编辑 JSON Canvas(.canvas)文件,含节点、连线、分组与连接。

来源:README.md(Skills → json-canvas)
CLI 与 Defuddle

通过 Obsidian CLI 与 vault 交互(含插件/主题开发),并用 Defuddle 从网页提取干净 Markdown、去除杂质以节省 token。

来源:README.md(Skills → obsidian-cli、defuddle)

技术架构

仓库是一个标准的 Agent Skills 集合:skills/ 下每个技能一个目录,含 SKILL.md(定义能力与触发),部分技能配 references/ 提供深入参考(如 obsidian-markdown 的 CALLOUTS/EMBEDS/PROPERTIES、obsidian-bases 的 FUNCTIONS_REFERENCE、json-canvas 的 EXAMPLES)。.claude-plugin(marketplace.json + plugin.json)使其可作为 Claude Code 插件分发。技能遵循 agentskills.io 规范,因而能被 Claude Code、Codex CLI、OpenCode 等自动发现并使用——OpenCode 会自动扫描 ~/.opencode/skills/ 下的所有 SKILL.md,无需改配置。

来源:README.md(首段规范说明、Installation 各方式);git tree(skills/*/SKILL.md、references/、.claude-plugin/)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Obsidian(含 Bases/Canvas/CLI 等能力)Obsidian(含 B… Defuddle CLI(网页提取)Defuddle CLI(… 兼容的智能体:Claude Code / Codex CLI / OpenCode兼容的智能体:Cl… Obsidian Markdown Bases 数据库 JSON Canvas CLI 与 Defuddle obsidian-skills 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Markdown(技能内容)框架Agent Skills 规范(agentskills.io);可作为 Claude Code 插件
Obsidian(含 Bases/Canvas/CLI 等能力)Defuddle CLI(网页提取)兼容的智能体:Claude Code / Codex CLI / Ope…
GitHub 仓库;通过插件 marketplace、npx skills 或手动安装分发
来源:README.md(首段规范、Skills 表、Installation);git tree(.claude-plugin/)

快速上手

多种安装方式:① Claude Code 插件 marketplace——/plugin marketplace add kepano/obsidian-skills 再 /plugin install obsidian@obsidian-skills;② npx skills add(git 或 https 链接);③ 手动——Claude Code 把仓库内容放到 vault 根的 /.claude 文件夹,Codex CLI 把 skills/ 目录复制到 ~/.codex/skills,OpenCode 则克隆整个仓库到 ~/.opencode/skills/obsidian-skills(注意要克隆完整仓库以保持目录结构,重启 OpenCode 后技能即可用)。安装后,智能体在处理 .md/.base/.canvas 等 Obsidian 文件或调用 CLI/Defuddle 时会自动套用相应技能。
来源:README.md(Installation 各方式)

使用场景

适合 Obsidian 用户让 AI 智能体真正按 Obsidian 的方式工作:用正确的 wikilink/嵌入/callout/properties 语法创建和整理笔记、构建 Bases 数据库视图与公式、生成或修改 Canvas 白板、通过 CLI 做 vault 操作或插件/主题开发,以及用 Defuddle 把网页内容抓成干净 Markdown 存入笔记。对在 Claude Code/Codex/OpenCode 等智能体里管理知识库的人尤其实用,避免 AI 用错 Obsidian 专有语法。

来源:README.md(Skills 表、首段定位)

优势与局限

优势

  • 由 Obsidian 相关的 kepano 出品,对 Obsidian 专有格式的覆盖准确、权威
  • 覆盖 Obsidian 核心格式与 CLI(Markdown/Bases/Canvas/CLI/Defuddle)
  • 遵循 Agent Skills 规范,跨 Claude Code/Codex/OpenCode 通用
  • 安装方式多样、配套 references 参考资料,开箱即用

局限

  • 聚焦 Obsidian 场景,非 Obsidian 用户用不上
  • 本质是知识/语法技能,效果取决于所用智能体与模型
  • 需要兼容 Agent Skills 的宿主,CLI/插件开发等高级用法有一定前置要求
  • 技能数量精简(5 个),覆盖 Obsidian 核心但不涵盖所有插件生态
来源:README.md(Skills 表、Installation、规范说明)

最新版本

本页未获取到正式发行版记录。项目以 Agent Skills 集合形式维护,通过 Claude Code 插件 marketplace、npx skills 与手动方式分发,更新以跟进 Obsidian 的格式(Markdown/Bases/Canvas)与 CLI 能力、完善各技能的参考资料为主。

来源:README.md(Installation、Skills 表);git tree(.claude-plugin/、references/)

总结评价

obsidian-skills 是把「让 AI 懂 Obsidian」这件事做对的权威之选:由 Obsidian 相关团队出品,准确覆盖 Markdown、Bases、Canvas、CLI 与网页提取,并遵循 Agent Skills 规范、跨主流智能体可用。对在智能体里管理 Obsidian 知识库的用户,它能有效避免 AI 用错专有语法、提升笔记自动化质量。它的边界很自然——只服务 Obsidian 场景、技能精简、依赖兼容宿主。作为 Obsidian + AI 的官方级技能集,它定位清晰、实用且可信度高。

来源:综合 README.md 的作者背景、格式覆盖与跨智能体兼容性
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 12:31. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件