Obsidian 知识库 Agent Skills
让 Agent 能正确读写 Obsidian Markdown、Bases、JSON Canvas，并通过 CLI 管理笔记、任务和插件。
技能说明
适合 Obsidian 知识库整理、结构化笔记、Canvas 和 Bases 管理，以及插件开发调试。仓库采用 MIT 许可证，支持 Claude Code、Codex 和 OpenCode 等兼容 Agent Skills 的工具。obsidian-cli 需要 Obsidian 正在运行，且可能创建、修改或执行 vault 中的内容；使用前请确认目标 vault、文件路径和外部内容来源。
关于此技能
Obsidian Agent Skills 是一组面向 Obsidian 知识库的实用技能，遵循开放的 Agent Skills 标准。它覆盖 Obsidian Flavored Markdown、Bases、JSON Canvas、Obsidian CLI，以及把网页整理成干净 Markdown 的 Defuddle。
核心能力
Obsidian Markdown
正确处理双链、嵌入、属性、标签、评论、Callout、Mermaid 和数学公式等 Obsidian 专用语法。
Bases 与 JSON Canvas
创建和编辑 Bases 数据视图，以及包含节点、连线和分组的 JSON Canvas 文件。
知识库命令行管理
通过 Obsidian CLI 读取、创建、搜索和整理笔记、任务、属性、标签与反向链接。
插件与网页整理
辅助调试 Obsidian 插件和主题，并用 Defuddle 从网页提取干净的 Markdown 内容。
适用场景
整理 Obsidian 知识库
需要批量创建笔记、补充属性、建立双链或维护任务时使用。
制作结构化知识视图
需要用 Bases 或 JSON Canvas 组织项目、资料和关系时使用。
开发 Obsidian 插件
需要重载插件、查看错误、检查界面或读取开发日志时使用。
保存网页资料
需要把网页正文去除噪音后整理进笔记或资料库时使用。
使用步骤
- 01
安装需要的技能
用 npx skills add https://github.com/kepano/obsidian-skills 安装，或按 README 使用 Claude Code 插件方式。
- 02
确认目标库
使用 CLI 前先打开 Obsidian，并明确要操作的 vault、文件名或路径。
- 03
先读后改
先读取当前笔记和属性，再创建、追加或修改内容；批量操作前先确认范围。
- 04
检查渲染结果
在 Obsidian 阅读视图中确认双链、嵌入、Callout、属性和 Canvas 显示正常。
常见问题
怎么安装？+
通用方式是 npx skills add https://github.com/kepano/obsidian-skills；Claude Code 也可以使用 /plugin marketplace add kepano/obsidian-skills 和 /plugin install obsidian@obsidian-skills。
不打开 Obsidian 能使用吗？+
Markdown、Bases、JSON Canvas 和网页整理技能可以独立使用；obsidian-cli 需要 Obsidian 正在运行，并且默认操作最近聚焦的 vault。
会不会直接修改我的笔记？+
CLI 技能可以创建、追加和修改文件。执行前应确认 vault 与路径，重要资料建议先备份，并避免把不受信任的内容直接写入或执行。
支持 Codex 吗？+
支持。README 明确说明可复制 skills 目录到 Codex 的技能路径，也适用于其他遵循 Agent Skills 标准的工具。
npx skills add https://github.com/kepano/obsidian-skills