1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | obsidian-skills |
| 作者/维护者 | Steph Ango（GitHub: kepano），Obsidian 联合创始人兼 CEO |
| 来源链接 | https://github.com/kepano/obsidian-skills |
| 许可证 | MIT（数据来自 GitHub API，仓库根目录含 LICENSE 原文） |
| GitHub Stars | 43,252（数据来自 GitHub API） |
| Forks | 3,083（数据来自 GitHub API） |
| 最新版本 | 1.0.1（plugin.json） |
| 安装方式 | Claude Code 插件市场 / npx 一行命令 / 手动复制目录 |
2. 功能介绍与亮点
本技能由 Obsidian 官方联合创始人亲自编写，共 5 个子技能，教会 agent 正确读写 Obsidian 生态的原生文件格式与官方工具：
- obsidian-markdown：Obsidian Flavored Markdown 专有语法——wikilink 双链、embed 嵌入、callout 提示框、frontmatter 属性
- obsidian-bases：
.base数据库视图文件——过滤器、公式、多种视图配置 - json-canvas：
.canvas可视化画布文件——节点、连线、分组 - obsidian-cli：调用官方命令行工具读写笔记、管理任务与属性，并支持插件/主题开发调试
- defuddle：用同作者的 Defuddle CLI 从网页提取干净 Markdown 正文，替代 WebFetch 节省 token
主要亮点：作者本人即 Obsidian 官方联合创始人兼 CEO，而非第三方对专有语法的逆向猜测；技能遵循开放的 Agent Skills 规范（agentskills.io），不绑定单一 agent；仓库已有 14 位以上外部贡献者的 PR 被合并，issue 区有真实具名的用户讨论与排障记录。
3. 适用场景
所属分类：内容创作与知识管理
Obsidian 笔记库用户借助 agent 创建笔记、生成 Bases 数据库视图与 Canvas 画布，需要产出符合 Obsidian 专有语法的文件而非普通 Markdown；也适合需要通过官方 CLI 批量管理笔记、任务与属性，或需要把网页内容干净提取为 Markdown 存入笔记库的用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。README 提供官方插件市场安装命令（
/plugin marketplace add+/plugin install），遵循 Claude 官方 Agent Skills 文档格式 - Codex：✅ 原生支持。README 提供 Codex 专用安装路径（复制
skills/目录到~/.codex/skills） - OpenClaw：❓ 未验证。README 与仓库 Issue 区均未点名 OpenClaw，未获取到直接证据
- Hermes Agent：✅ 已验证。仓库 Issue #71 中两位独立用户（nickradford、JBScoutDE）分别确认技能可在 Hermes Agent 中正常安装与运行
5. 推荐理由
由 Obsidian 联合创始人兼 CEO 亲自开发维护，不是第三方对其专有语法的逆向猜测；一次安装即可让 agent 同时掌握 Obsidian 全部核心文件格式（Markdown / Bases / Canvas）与官方 CLI 操作，覆盖“读笔记、写笔记、建数据库视图、画布可视化、网页转笔记”全链路；4 万余星、真实的外部贡献与 issue 讨论验证了大规模实际使用，而非孤立的小众实验。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 10 | 作者为 Obsidian 联合创始人兼 CEO 本人，GitHub 43,252 stars、3,083 forks、14+ 位外部贡献者合并 PR，具备官方权威性与真实社区参与度 |
| 可用性 | 9 | 插件市场一键安装、npx 一行命令、手动复制三种途径均可用；SKILL.md 文档结构完整并附带详细参考文档；2026-06-08 仍有 PR 合并；Obsidian 核心应用个人与商业使用均免费，无强制付费依赖 |
| 安全性 | 8 | 见下方检查清单——本地 CLI 代码执行范围限定在笔记库与用户指定网页，无隐藏外联，MIT 许可证明确 |
安全检查清单： ① 是否执行 shell 命令：是，通过官方 Obsidian CLI 与本机安装的 defuddle CLI 执行，范围限定在笔记库读写、任务/属性管理与插件调试，无越权操作 ② 是否联网外发数据：仅 defuddle 子技能会请求用户显式提供的网页 URL 用于提取正文，目标透明，未发现隐藏遥测 ③ 是否要求 API key/凭据：无需任何凭据 ④ 可疑指令：未发现 prompt injection、混淆代码或隐蔽外发迹象 ⑤ 作者/组织信誉：Steph Ango 为 Obsidian 官方联合创始人兼 CEO，身份可核实（公开资料一致），无刷星或自我营销迹象 ⑥ License 是否明确：MIT，明确 ⑦ 最近维护时间：2026-06-08 有 PR 合并
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| obsidian-second-brain | 让笔记库自我改写、自动调和矛盾内容的自治型工具 | 面向“库内容自动整理”，不教授 Obsidian 原生格式语法本身；依赖 agent 自主决策改写笔记，自主性更高 |
| claude-obsidian | 自动摄取笔记并维护知识图谱的“第二大脑”工具 | 聚焦自动化知识图谱构建，是搭建在 Obsidian 之上的一层应用逻辑，不是原生格式规范的权威参考 |
| obsidian-wiki | 把 LLM Wiki 理念搬进 Obsidian 的知识库框架模板 | 提供的是一套内容组织方法论模板，而非 Obsidian 原生文件格式（Markdown/Bases/Canvas）的权威语法参考 |
obsidian-skills 定位是“格式与工具层”的官方权威参考，其他自动化、知识管理类工具可以依赖它，而非与它们竞争同一层功能。
8. 用户评价
- Soleone（GitHub Issue #1）：安装初期误以为技能未被识别，在作者与社区成员协助排查后确认这是 Claude 技能发现机制的已知限制而非配置错误，最终反馈“Works now, thanks! I was able to install it and then activate it locally in the obsidian vault only.”
- JBScoutDE（GitHub Issue #71）：在被问及是否支持 Hermes Agent 时回复“I can confirm that the skills work also in Hermes Agent :)”，独立验证了该技能在 Hermes Agent 生态下的可用性。
9. 安装使用方式
Claude Code 插件市场（推荐）：
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills注意：市场内部标识为 “obsidian”，不是仓库名 “obsidian-skills”。
npx 一行安装（适用多数 agent）：
npx skills add https://github.com/kepano/obsidian-skillsCodex： 将 skills/ 目录复制到 ~/.codex/skills
OpenCode： 克隆整个仓库到 ~/.opencode/skills/obsidian-skills（需保留完整目录结构，而非仅内层 skills/ 文件夹）
安装后注意事项： defuddle 子技能需额外执行 npm install -g defuddle；obsidian-cli 子技能要求本机已打开 Obsidian 应用并开启官方 CLI 功能；部分 agent 在库内局部安装路径下需要用户明确提示“使用 Obsidian markdown 技能”才会主动触发。
10. 注意事项
- 部分用户反馈技能放在库内
.claude/skills而非全局~/.claude/skills时未被自动识别，需显式提示才能触发，属 Claude 技能发现机制的已知限制 - obsidian-cli 子技能要求本机已安装并运行 Obsidian 桌面应用，纯服务器或无头环境无法使用
- 跨 Agent 覆盖尚未获取 OpenClaw 的直接验证证据，采用该生态的用户建议先小范围测试