9天狂增6.6万Star！Obsidian CEO开源三大独家技能

智猩猩AI整理

编辑：没方
就在上周，Obsidian 官方直接炸了个重磅消息！CEO Steph Ango（也就是大家熟知的 kepano）在 X 平台突然官宣，他亲自为 Obsidian 打造了一套专属的 Claude Skills，直接让 Claude 智能体拥有了操作Obsidian笔记的能力。

在此之前，智能体处理Obsidian笔记时，常常会搞乱Obsidian的专属语法（如维基链接、提示框等）以及破坏 canvas结构。而Obsidian Skills就是精准解决这个痛点，它能让 Claude Code正确处理和修改 Obsidian 的 .md、.base 和 .canvas文件 。

项目上线仅9天，就在 GitHub 斩获 6.6k Star，成为 Obsidian 社区最受瞩目的效率神器。

• 
  

  项目地址：

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

01

项目介绍

Agent Skills 是 Anthropic 推出的一项开放标准，旨在为 AI Agent提供专业化、可复用的能力模块。通过 Agent Skills，Claude 被赋予一组预定义的工具或技能使其能够自主执行特定任务，而无需用户逐条下达详细指令。这一机制不仅提升了人机协作的效率，还确保了操作的安全性与上下文感知能力，让 Claude 能够更智能、更精准地融入开发、写作和知识管理工作流。

Obsidian Skills 是由 Obsidian官方主导开发的一组开源工具，它遵循Agent Skills 技术规范，能帮助 Claude Code、Codex CLI 等所有兼容该规范的AI 智能体，精准理解并生成符合 Obsidian 格式的内容。该开源项目包含三大技能模块，分别对应 Obsidian 的三种核心文件格式：

（1）obsidian-markdown

obsidian-markdown 是专为智能体打造的 Obsidian 风味 Markdown 操作工具，它让兼容 Agent Skills 规范的智能体能精准理解、创建和编辑 Obsidian 专属的 .md 笔记，完美适配 Obsidian 扩展语法与使用场景，彻底解决智能体编辑时出现的语法错乱、格式不兼容问题。

obsidian-markdown不仅支持CommonMark、GitHub Flavored Markdown 等通用语法，更深度适配 Obsidian 独有的扩展功能，包括用于内部笔记连接的 wikilinks、用于内容嵌入的 embed 语法、用于高亮信息块的 callouts，以及用于结构化元数据的 properties（frontmatter）。该技能能够创建从简单笔记到具有交叉引用、数学公式、图表和交互元素的复杂文档系统。

（2）json-canvas

json-canvas技能让智能体能够创建和编辑Obsidian的.canvas文件，该格式以结构化的 JSON 数据描述画布内容。

该技能支持定义多种节点类型，包括：文本节点（含 Markdown 内容）、文件节点（引用 Obsidian 库内笔记、图片等资源）、链接节点（指向外部 URL）以及组节点（作为可视化容器组织其他元素）。

该技能可建立连接任意两个节点的边，从而构建思维导图的分支结构、流程图的逻辑或知识网络的关系。

该技能还包括建立x/y 坐标精确定位、z-index 层级控制、支持十六进制颜色以及严格的格式验证规则，可生成从简单头脑风暴草图到包含分组、多类型连接、复杂项目管理看板等各类可视化内容。

（3）obsidian-bases

obsidian-bases 技能让智能体能够创建和编辑 Obsidian 专属的 .base 文件，无需用户手动编写底层代码，轻松解锁接近数据库的灵活查询与可视化能力。

Obsidian中的 .base 将库中分散的 .md 笔记动态聚合为可视化的虚拟数据库，不修改任何原始笔记，而是通过解析笔记的元数据、文件属性（如名称、路径、修改时间、标签等），结合过滤器、公式和视图配置生成表格、卡片、列表等多种动态视图，从而实现结构化的知识组织与高效检索。

02

使用方法

Obsidian Skills的安装非常简单，并且可以适配不同智能体工具。

• 针对 Claude Code：下载Obsidian Skills 项目源码，将其放置到 Obsidian 笔记库根目录下的.claude 文件夹中，Claude Code便会自动识别并加载该技能。此外，也可直接在Claude Code中输入提示词：直接安装GitHub仓库 https://github.com/kepano/obsidian-skills 中对应Skills。
• 针对 Codex CLI：将 Obsidian Skills 项目中的skills目录完整复制到Codex CLI的.codex/skills 路径下，工具会自动识别符合 Agent Skills 规范的技能，无需额外配置即可直接调用。

03

总结

Obsidian 官方推出的 Obsidian Skills 不仅是一套技术工具，更是其尊重用户自主性理念的延续。Obsidian 没有选择“一键集成 AI”的捷径，而是主动开源了针对其三大核心文件格式（.md、.base、.canvas）的 Agent Skills，让用户在本地或受控环境中，自由选择兼容的智能体进行高效协作。

这一做法既解决了智能体对 Obsidian 专属语法“水土不服”的痛点，又避免了将敏感知识库暴露给外部服务的风险。Obsidian 没有把 AI 变成黑箱功能塞进软件，而是赋予用户透明、可复用的能力模块，这正是其“用户拥有数据、工具服务于人”初心的最佳体现。