obsidian-skills 是什么?

obsidian-skills 是 kepano 维护的一组 Agent Skills,用来教 Claude Code、Codex、OpenCode 等工具正确处理 Obsidian Markdown、Bases、JSON Canvas、Obsidian CLI、Defuddle 和 Knap。仓库本身主要是说明文件与参考资料,不是一个常驻后台或 Obsidian 插件。

⭐ 33,990 Stars 🍴 2,398 Forks — — 作者: kepano
来源:github.com/kepano/obsidian-skills/blob/main/README.md 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

它把 Obsidian 的开放格式与 CLI 规则包装成通用 Agent Skills,可通过插件市场、`npx skills add` 或手工复制使用,覆盖的 Agent 比单一厂商插件更广。

来源:github.com/kepano/obsidian-skills/blob/main/README.md

核心功能

Obsidian Markdown 规则

指导 Agent 处理属性、wikilink、嵌入、callout 等 Obsidian 特有 Markdown 语法。

来源:github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown
Bases 与 JSON Canvas

分别描述 `.base` 的视图、过滤、公式、摘要,以及 `.canvas` 的节点、边、分组和连接结构。

来源:github.com/kepano/obsidian-skills/tree/main/skills
Obsidian CLI 工作流

要求 Obsidian 正在运行,可从 CLI 读取、创建、搜索和修改笔记,也覆盖插件重载、错误、截图和 DOM 检查。

来源:github.com/kepano/obsidian-skills/blob/main/skills/obsidian-cli/SKILL.md
网页与批量模板辅助

Defuddle skill 从 URL 提取 Markdown;Knap skill 根据 JSON 或 CSV 渲染 Markdown 模板和批量文件。

来源:github.com/kepano/obsidian-skills/blob/main/README.md

技术架构

仓库以 `skills/<name>/SKILL.md` 为单元,遵循 Agent Skills 规范。Agent 在触发任务时读取对应说明,再调用本地文件工具、正在运行的 Obsidian CLI,或 Defuddle/Knap 等外部 CLI。技能文件不提供独立权限隔离:能读写哪些 vault 文件、能否联网和能否运行开发命令,取决于宿主 Agent 的工作目录、工具授权与 Obsidian 当前焦点。

来源:github.com/kepano/obsidian-skills/blob/main/README.md;https://github.…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 兼容 Agent Skills 的宿主兼容 Agent Ski… Obsidian 与 Obsidian CLI(CLI skill)Obsidian 与 Ob… Defuddle CLI(网页提取)Defuddle CLI(… Knap(模板渲染) Obsidian Markdown 规则Obsidian Markdown… Bases 与 JSON Canvas Obsidian CLI 工作流 网页与批量模板辅助 obsidian-skills 项目本体 核心功能 关键依赖

技术栈

语言Markdown/YAML 技能说明框架Agent Skills specification
兼容 Agent Skills 的宿主Obsidian 与 Obsidian CLI(CLI skill)Defuddle CLI(网页提取)Knap(模板渲染)
技能目录安装;不含独立服务或数据库
来源:github.com/kepano/obsidian-skills/blob/main/README.md

快速上手

先在测试目录执行 `npx skills add https://github.com/kepano/obsidian-skills`,只启用需要的技能,并查看写入的技能目录。Codex 也可把 `skills/` 复制到 `~/.codex/skills`。使用 `obsidian-cli` 技能前需打开 Obsidian,并显式指定 `vault=<name>` 与 `path=<vault 内路径>`,避免命令落到最近聚焦的其他 vault。Defuddle 会访问给定 URL,敏感内网页面不要直接交给它。
来源:github.com/kepano/obsidian-skills/blob/main/README.md;https://github.…

使用场景

适合让编码 Agent 生成符合 Obsidian 语法的笔记、Bases 和 Canvas,或在明确 vault 中做搜索、属性更新、插件调试与批量模板生成。它不能替代权限控制、备份或人工检查。

来源:github.com/kepano/obsidian-skills/blob/main/README.md

优势与局限

优势

  • 覆盖 Obsidian 三种开放文件格式
  • 遵循通用 Agent Skills 规范
  • 安装方式覆盖多种宿主
  • 技能内容可直接审阅

局限

  • 官方 Releases 页面没有版本,更新需固定提交自行追踪
  • CLI 默认作用于最近聚焦 vault,目标不明确会误写
  • 插件开发命令可执行 JavaScript、读取 DOM 和截图
  • Defuddle 会向目标 URL 发起网络请求
来源:github.com/kepano/obsidian-skills/releases;https://github.com/kepano/…

最新版本

截至 2026-09-23,GitHub Releases 页面显示没有正式 Release。仓库按 main 分支持续维护;需要稳定复现时应固定审核过的提交,并在升级前查看技能文本差异。

来源:github.com/kepano/obsidian-skills/releases

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、Releases、obsidian-cli 与 defuddle 两个 SKILL 文件  |  limitations: 未执行 npx、未复制技能、未打开 Obsidian、未读写 vault、未运行 CLI/Defuddle/Knap 或插件开发命令  |  observed_output: 官方 Releases 页面无正式版本;README 列出 6 个技能和三类安装入口;CLI skill 明确要求 Obsidian 正在运行并默认使用最近聚焦的 vault

来源:github.com/kepano/obsidian-skills/releases;https://github.com/kepano/…

同类项目对比

相比 Obsidian Mind,obsidian-skills 只提供格式和工具操作说明,不规定人物、项目、决策等 vault 结构,也不自带会话 hooks 或持久记忆工作流;Obsidian Mind 是完整 vault 模板,并把 obsidian-skills/CLI 作为组成部分。想保留现有 vault 结构时优先选技能集,想采用一整套工作记忆体系时再评估 Obsidian Mind。

来源:github.com/kepano/obsidian-skills/blob/main/README.md;https://github.…

总结评价

这是给现有 Obsidian 工作流补充 Agent 格式知识的轻量方案。价值在可读、可拆分;风险在宿主权限会直接变成 vault 读写能力。先固定提交、只装所需技能,并在副本 vault 中检查命令目标。

来源:github.com/kepano/obsidian-skills/blob/main/README.md

常见问题

obsidian-skills 有正式版本号吗?

截至 2026-09-23,官方 Releases 页面没有发布版本。需要可复现安装时应记录具体 Git 提交,而不是只写 `main`。

安装 obsidian-skills 后 Agent 能读整个 vault 吗?

技能文件不会自行授权,但宿主 Agent 和 Obsidian CLI 能访问的范围决定实际权限。CLI 默认使用最近聚焦的 vault,操作时应显式写 vault 与 path。

obsidian-skills 的 Defuddle 会把内容发到外部服务吗?

技能指示本地 Defuddle CLI 访问指定 URL 并提取页面。请求会到目标网站;内网页面、带凭据 URL 和敏感内容需要先做网络与日志审查。

obsidian-skills 和 Obsidian Mind 是同一个东西吗?

不是。obsidian-skills 是格式与工具说明集合;Obsidian Mind 是带目录结构、hooks、命令、索引和记忆流程的完整 vault 模板。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件