Obsidian Skills：教 AI Agent 正确读写 Obsidian 笔记、Bases 与 Canvas
一分钟看懂
Obsidian Skills 是 Obsidian CEO kepano 维护的一组 Agent Skills。它把 Obsidian 特有的 Markdown、Bases 数据视图、JSON Canvas、CLI 和网页正文提取规则写成标准化技能，让 Claude Code、Codex CLI、OpenCode 等兼容 Agent 在操作 vault 时少犯格式错误。
你可以用它做什么
- 创建含属性、wikilink、嵌入、callout 和标签的 Obsidian 笔记。
- 生成或维护 .base 文件，用过滤、公式、表格、卡片、列表和地图视图组织笔记。
- 编辑 .canvas，创建节点、连线、分组和空间化知识图。
- 通过 Obsidian CLI 管理 vault，并辅助插件或主题开发。
- 用 Defuddle 从网页提取干净 Markdown，减少无关内容和 token。
主要能力
仓库当前包含 obsidian-markdown、obsidian-bases、json-canvas、obsidian-cli 与 defuddle 等技能。每个技能使用 Agent Skills 规范的 SKILL.md，附带语法、工作流、校验规则和参考资料。它可通过插件市场、npx skills add 或手工复制安装，且不绑定单一模型厂商。
适合哪些人
适合把 Obsidian 当作个人知识库、研究库或内容系统，并希望让编码 Agent 安全批量整理文件的用户；也适合 Obsidian 插件开发者。若只是让聊天机器人概括几段文字，不一定需要整套技能。
怎么开始使用
可执行 npx skills add https://github.com/kepano/obsidian-skills，或按 README 把 skills 目录放入 Codex 的技能目录。Claude Code 可通过仓库 marketplace 安装；OpenCode 需要保留完整仓库目录结构。重启 Agent 后，先在 vault 副本中要求它创建一篇示例笔记、一个 Base 和一个 Canvas，确认 Obsidian 能正常打开再处理真实资料。
使用前需要知道
Skills 是给 Agent 的指令，不是 Obsidian 插件，也不会自动保证内容正确。Agent 可能批量改名、移动或重写 Markdown，操作前应把 vault 纳入 Git 或可靠备份，并限制工作目录。Bases 与 Canvas 格式会随 Obsidian 演进，需跟随仓库更新。Defuddle 抽取网页时仍应遵守版权和站点使用条款。