项目简介

obsidian-skills 是 kepano 维护的一套 面向 Obsidian 的 Agent Skills 集合。它遵循 Agent Skills 规范，因此不只适用于某一个 AI 工具，而是可以给 Claude Code、Codex CLI 这类兼容 Agent 直接使用。

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

如果把 Obsidian 里的内容分成几层来理解，这套 skill 基本覆盖了三类最常见的需求：

  1. 写 Markdown 笔记时，要懂 Obsidian 语法
  2. 做结构化内容时，要会操作 Bases 和 Canvas
  3. 处理外部网页时，要能先清洗成干净的 Markdown

它不是一个单独的插件，而更像是一套给 AI 看的“操作说明书 + 工作规程”。AI 按照这套规程去做事，就更容易写出符合 Obsidian 习惯的内容，而不是只会输出普通 Markdown。

主要功能组件 (Skills)

Skill 说明
obsidian-markdown 创建和编辑 Obsidian Flavored Markdown (.md)；支持 wikilinks、embeds、callouts、properties 以及其他 Obsidian 专属语法。
obsidian-bases 创建和编辑 Obsidian Bases (.base)；支持视图、过滤器、公式和 summaries。
json-canvas 创建和编辑 JSON Canvas 文件 (.canvas)；支持 nodes、edges、groups 和 connections。
obsidian-cli 通过 Obsidian CLI 与 Obsidian vault 交互，也可用于插件和主题开发。
defuddle 使用 Defuddle CLI 从网页提取干净 Markdown，去掉杂讯，节省 token。

obsidian-markdown解决的问题

最基础，也最常用。它教 AI 怎么正确处理 Obsidian 的 Markdown 扩展语法，比如：

  • [[双链]]
  • ![[嵌入]]
  • > [!callout]
  • frontmatter 里的属性
  • 标签、注释、脚注、数学公式等

如果你希望 AI 帮你改笔记，但又不想把 Obsidian 特有语法改坏，这个 skill 就是核心。

obsidian-bases解决的问题

这是给 Obsidian 的 Bases 用的。你可以把它理解成 Obsidian 里的轻量数据库视图：

  • table view
  • cards view
  • list view
  • map view
  • filters
  • formulas
  • summaries

它适合做结构化整理，比如任务、阅读清单、项目索引、资料库视图。

json-canvas解决的问题

这个 skill 主要是帮 AI 创建和编辑 .canvas 文件。

它关注的是：

  • 节点（nodes）
  • 连线（edges）
  • 分组（groups）
  • 布局坐标
  • JSON 结构合法性

适合做思维导图、流程图、项目画布、研究路径图。

obsidian-cli解决的问题

这是最偏“工程化”的一个 skill。它不是在笔记文本层面打转，而是通过 Obsidian CLI 直接和 vault 交互。

这类能力通常适合：

  • 批量读写笔记
  • 搜索 vault 内容
  • 处理任务、属性、标签
  • 插件和主题开发
  • 调试和截图

如果说 obsidian-markdown 更像“会写 Obsidian 笔记”，那 obsidian-cli 更像“会操作 Obsidian 库”。

defuddle解决的问题

它的作用是把网页正文清洗成适合笔记使用的 Markdown。

这对 AI 很重要，因为网页原始内容通常有：

  • 导航栏
  • 广告
  • 页面装饰
  • 无关脚本
  • 大量重复噪音

defuddle 的价值就是先把这些杂讯剥掉，再把干净内容交给 AI 处理，既省 token，也更适合沉淀进 Obsidian。

安装方法

插件市场 (Marketplace)

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

使用 npx skills

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

手动安装

  • Claude Code：把整个仓库内容放到 Obsidian vault 根目录下的 /.claude 文件夹。
  • Codex CLI：把 skills/ 目录复制到 Codex 的 skills 路径，通常是 ~/.codex/skills。
  • OpenCode：克隆完整仓库到 ~/.opencode/skills/obsidian-skills，不要只拷贝内层 skills/ 文件夹。

适合什么人用

如果你只是想让 AI 帮你润色一两段文字，普通提示词就够了。
但如果你已经在 Obsidian 里建立了比较完整的知识库，并且希望 AI 能更懂：

  • Obsidian 特有语法
  • 数据化视图
  • 画布结构
  • vault 级别操作
  • 网页转笔记流程

那 obsidian-skills 就很值得装。

总结

obsidian-skills 是一套由 kepano 维护、面向 Obsidian 的 Agent Skills 集合，核心目标是让 AI 更好地理解和操作 Obsidian 生态。它覆盖了 Obsidian Flavored Markdown、Bases、Canvas、Obsidian CLI 以及网页内容清洗等常见场景，帮助 AI 在写笔记、处理结构化数据、编辑画布和整理网页资料时，更符合 Obsidian 的工作方式。对于已经深度使用 Obsidian 的用户来说，这套 skills 能显著提升 AI 辅助整理知识库的效率和准确度。

参考

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