obsidian-skills：让 AI 会读、会写、会画你 Obsidian 知识库的 5 个技能

obsidian-skills：让 AI 会读、会写、会画你 Obsidian 知识库的 5 个技能

【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills

核心关键词：obsidian-skills、Obsidian AI 技能、知识库自动化、Obsidian CLI、JSON Canvas

长尾关键词：Obsidian 技能安装教程、AI 自动创建笔记、Obsidian Bases 数据库视图配置、思维导图 Canvas 文件创建、网页内容智能提取、Obsidian 插件开发调试流程、AI 助手接入知识库

想让 AI 帮你整理笔记，但它要么语法写错、要么只会纸上谈兵？obsidian-skills直接解决这件事：它把 5 个 Obsidian 生态专用技能装进你的 AI 助手，让它真正会读、会写、会改你的知识库。

🧭 先搞清楚：它是什么，不是什么

obsidian-skills是一套遵循 Agent Skills 开放规范的Agent Skills（可以理解为 AI 助手按需查阅的"技能说明书"），Claude Code、Codex、OpenCode 这些支持该规范的平台都能用。

它不是什么：

• 不是 Obsidian 插件：不改动 Obsidian 本体，也无需在应用里安装
• 不是另一套笔记软件：它不存储任何内容，只是教会 AI 用正确的语法和工具操作你的库

一句话：Obsidian 继续负责存储和展示，AI 从此学会正确使用它。

🧩 5 个技能模块总览

每个模块都自带SKILL.md说明书和参考资料，AI 用到哪块就自动查哪块。比如做 Bases 时，AI 会翻阅完整的函数手册 FUNCTIONS_REFERENCE.md，公式不容易写错。

🛠️ 实战：三个即开即用的流程

把网页文章变成可追踪的阅读库

场景：收藏了一堆技术文章，笔记格式五花八门，读完没读全靠记忆。

操作分三步走：

1. 让 AI 用 defuddle 提取文章，只拿正文，省掉网页噪音
2. 让 obsidian-markdown 生成标准化笔记：frontmatter 里带status、author，正文用维基链接连到已有笔记
3. 让 obsidian-bases 生成.base文件，笔记列表自动变成数据库

# 提取干净 Markdown 并保存 defuddle parse <url> --md -o content.md # 建笔记、设属性，让数据库视图自动更新 obsidian create name="文献笔记" content="# 论文A\n\n[[研究背景]]" obsidian property:set name="status" value="reading" file="文献笔记"

拿到的效果：以后每读一篇文章，只需"提取 → 入库 → 改状态"，阅读清单永远是最新状态，不用手动整理。

把散落任务变成看板视图

场景：任务记在各种笔记里，哪些逾期了只有打开一个个文件才知道。

让 AI 写好下面这个.base文件：过滤器圈出未完成任务，公式自动算出"距截止还有几天"，没填截止日期的任务也不会报错（if()做了保护）。

filters: and: - file.hasTag("task") - 'status != "done"' formulas: days_until_due: 'if(due, (date(due) - today()).days, "")' views: - type: table name: "进行中的任务" order: [file.name, status, formula.days_until_due, due]

拿到的效果：在 Obsidian 里打开就是一个按状态分组的任务表格，逾期任务一目了然。

把概念图变成可视化画布

场景：讲一个架构或思路，纯文字说不清。

让 AI 直接写.canvas文件——一个文本节点加一条连线就是最小画布，更完整的示例见 EXAMPLES.md：

{ "nodes": [ {"id": "6f0ad84f44ce9c17", "type": "text", "x": 0, "y": 0, "width": 400, "height": 200, "text": "# 核心概念"} ], "edges": [] }

拿到的效果：Obsidian 里打开即是可拖拽的图形。节点还能引用笔记、图片和外链，画完直接发给同事。

📦 上手指南：三步接入你的 AI 平台

前提只有三个：Obsidian 已装好并打开一个库、一个支持技能体系的 AI 平台、仓库代码到手。

1. Claude Code 用户：把仓库内容放进库根目录的.claude文件夹，AI 处理该库文件时自动读取技能
2. Codex 用户：复制skills/目录到 Codex 技能路径（通常是~/.codex/skills）
3. OpenCode 用户：克隆整个仓库到技能目录——只拷内层skills/文件夹会导致自动发现失败

git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills \ ~/.opencode/skills/obsidian-skills

重启一次 OpenCode 即可。它会扫描所有SKILL.md文件，无需改任何配置。

提示：如果你在写 Obsidian 插件，obsidian-cli 模块还提供plugin:reload、dev:errors、dev:screenshot等命令，改完代码在终端一轮就能完成重载、查错、截图验证。完整清单见 skills/obsidian-cli。

🕳️ 避坑指南：5 个高频问题

🔭 进阶方向

• 做仪表盘：用![[MyBase.base]]把任意.base视图嵌进笔记，把库首页变成数据总览页
• 深度查询：obsidian eval code="..."可在应用上下文里直接跑 JavaScript，让 AI 做更复杂的库内统计
• 自己加技能：技能遵循 Agent Skills 开放规范，照SKILL.md的格式就能写新模块放进技能目录

✅ 最后记住这几点

• 正确性有保证：AI 按官方语法写笔记、Bases 和画布，不用你手动修格式
• 流程能串起来：提取 → 结构化 → 建库 → 可视化，一条工作流闭环
• 跨平台：一套技能，Claude Code、Codex、OpenCode 通吃
• 零额外成本：不装插件、不订阅，复制一份代码就能开始

现在打开你的库，把技能放进去，然后对 AI 说"把这个文件夹的笔记整理成一张表格"，看它自己完成。

【免费下载链接】obsidian-skillsAgent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.项目地址: https://gitcode.com/GitHub_Trending/ob/obsidian-skills