使用 obsidian-skills 自动化 Obsidian 笔记，适用于 Claude 与 Codex

介绍 obsidian‑skills

如果您深度参与 Obsidian 生态系统，并且也喜欢 Claude 或 Codex，您会想让所有工具之间互通。GitHub 项目

kepano/obsidian-skills

完全满足这一需求——一个为 Obsidian 构建的开源 Agent Skills 集合。这些技能基于以下基础：

• Agent Skills 规范（与 Claude Code 与 Codex CLI 使用的相同格式）
• Obsidian 兼容文件类型（Markdown、Obsidian‑Base、JSON‑Canvas）
• MIT 许可，免费且可轻松复用。

在本指南中，我们将逐步说明 为什么 您应该采用此项目、如何安装，以及使用 Claude 制作笔记的实战示例。

obsidian‑skills 解决了哪些问题？

1. 自动化 – 您不必手动打开一个新的 .md 文件，直接向 Claude/Codex 发送提示，笔记即可即时生成。
2. 一致性 – 所有写入 Obsidian 的代理使用相同的技能模式，格式、代码块与元数据保持统一。
3. 跨平台 – 无论是在 Windows、macOS、Linux，还是使用云端 vault，均可使用相同的技能集合。

如果没有技能插件，您需要：

• 手动编辑文件
• 在 Obsidian 外编写自定义脚本
• 在每个代理中手动管理文件路径

使用 obsidian‑skills，繁重的工作由插件完成。

安装路径

1. Obsidian 插件市场（推荐）

1. 在 Obsidian 中打开 设置 → 社区插件 → 浏览。
2. 搜索 obsidian‑skills。
3. 点击 安装 然后 启用。

插件会被安装到 /.obsidian/plugins/obsidian-skills，并自动注册供 Claude 与 Codex 使用。

2. 手动安装（适用于 codex cli 或本地 Claude 环境）

• Claude Code – 将整个 skills/ 文件夹复制到 vault 根目录或已映射到 /.claude 的任意文件夹。
• Codex CLI – 将 skills/ 文件夹放入 ~/.codex/skills 目录。

放置后重启代理，即可加载新技能。

使用技能

安装完成后，技能会暴露一组代理可调用的动词。以下为发送给 Claude 的示例提示：

Prompt

Use the skill `obsidian-create-note` to create a new note titled "Obsidian‑Skills Demo" with the content:
- Introduction
- How to install
- Quick usage

Result – 一个名为 Obsidian‑Skills Demo.md 的新文件出现于您的 vault，已按 Obsidian‑Markdown 规则格式化。

这有何用？ 您可以通过语音或文字草拟会议纪要、研究笔记或待办清单，文件即时可用于 Obsidian 图谱、反链及社区插件。

常用命令

每项技能遵循 Agent Skills 规范，若您需要更定制的行为，也可自行编写技能包装器。

扩展技能

由于仓库开源，您可 fork 并添加新功能：

1. 在 skills/ 下创建新技能文件夹。
2. 添加 manifest.json（包含名称、描述和输入格式）。
3. 添加 handler.py（Python）或 handler.js（JavaScript）与 Obsidian 本地文件系统交互。
4. 提交并推送。新技能将对任何支持该规范的代理可用。

欢迎社区贡献——若发现 bug 或想要新功能，提交 PR 或 issue。

开始使用清单

• 从 Obsidian 市场安装或将文件夹复制到 /.claude。
• 撰写第一个提示（参见上例）。
• 验证笔记出现且格式正确。
• 使用 obsidian-list-notes 探索技能列表。
• 若感兴趣，分享 gist 或撰写教程。

结论

若您已在使用 Claude、Codex 或任何 Agent Skills 兼容代理，obsidian‑skills 是一座桥梁，可将您的笔记视为一流的数据对象。只需几次点击即可：

• 零触碰创建笔记
• 一致的 Markdown 格式
• 语音或聊天快速编辑
• 与 Obsidian 强大图谱及社区生态无缝集成

前往 GitHub 页面，星标仓库、提交 PR 或仅仅在聊天中开始输入。祝笔记愉快！