让 AI 助手玩转 Obsidian：obsidian-skills 从安装到实战的完整指南

让 AI 助手玩转 Obsidianobsidian-skills 从安装到实战的完整指南【免费下载链接】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-skillsobsidian-skills 是一套给 AI Agent 用的技能包装好之后Claude Code 这类助手就能看懂 Obsidian 的方言——wikilink、callout、属性头还会维护.base数据库视图和.canvas画布文件甚至能通过命令行直接操作你的库。下面按装好 → 会用 → 排坑的顺序带你把它跑起来。AI 写 Obsidian 文件最容易翻车的 3 个地方如果你试过直接让 AI 往 Obsidian 库里写文件大概率踩过这些坑链接写法不对库里笔记该用[[wikilink]]AI 却给你写成标准 Markdown 链接改名后链接全断Bases 视图打不开.base文件本质是 YAML公式里带个冒号或引号没配对整个视图直接报错画布文件损坏.canvas对 ID 唯一性、连线引用、换行符都有严格要求AI 随手一生成就容易坏问题不在 AI 不够聪明而在于它不知道 Obsidian 这些方言的规矩。obsidian-skills 的作用就是把规则写进技能文档里让 Agent 照着执行。它遵循 Agent Skills 开放规范所以 Claude Code、Codex、OpenCode 等兼容工具都能用。最快上手3 种方式给 Agent 装上技能包按你用的 Agent 工具选一种即可装完不需要动 Obsidian 本体。用 marketplace 一行命令安装在兼容 marketplace 的环境里先添加市场再装技能/plugin marketplace add kepano/obsidian-skills /plugin install obsidianobsidian-skills用 npx skills add 安装终端里执行npx skills add再加上仓库地址即可。注意仓库地址可以选 ssh 或 https 两种形式按你机器的 git 凭证情况挑一个。手动放到技能目录如果前两种用不了直接把仓库里的skills/文件夹放到对应位置Claude Code放进 Obsidian 库根目录或你工作目录下的.claude文件夹Codex复制到~/.codex/skillsOpenCode把整个仓库克隆到~/.opencode/skills/下注意必须保留完整的目录层级只拷内层的skills/文件夹是不行的重启 OpenCode 后自动发现全部技能5 个技能模块各管一摊先认个脸技能包里有五个模块AI 会根据你要处理的内容自动挑对应的那一个模块管什么obsidian-markdown笔记里的 Obsidian 特有语法obsidian-bases.base动态视图与公式json-canvas.canvas画布的节点和连线obsidian-cli命令行操作打开中的 Obsidiandefuddle网页转干净 MarkdownMarkdown 技能解决笔记写得不够 Obsidian的问题。它教 AI 三件核心的事内部链接一律用 wikilink还能精确到某个标题、某个段落块内容嵌入用![[...]]图片、PDF 某一页都行重点信息用 callout 框高亮。属性头、嵌套标签、LaTeX、Mermaid 图表这些它也都覆盖了细节分别写在 PROPERTIES.md、EMBEDS.md、CALLOUTS.md 三份参考文档里。Bases 技能让 AI 会给你搭库内数据库。.base文件里它能写全局和分视图的筛选条件按标签、文件夹、属性、日期过滤定义公式做计算再配上表格、卡片、列表、地图四种视图。技能文档里自带三个现成模板思路任务追踪看板带是否逾期判断、阅读清单卡片视图放封面、每日笔记索引按日期正则匹配文件名。公式部分还内置了易错点的说明比如两个日期相减得到的是 Duration 类型要先取.days再取整——这种细节正是 AI 最容易翻车的地方技能文档里已经写清楚了。JSON Canvas 技能负责画布文件。AI 能生成文本、文件、链接、分组四类节点处理好 ID 唯一性、坐标排版节点间距、组内留白、对齐网格并按 EXAMPLES.md 里的范式产出思维导图、项目看板这类完整画布。CLI 技能让 AI 直接操作一个正开着的 Obsidian 实例搜索笔记、建笔记、往每日笔记追加待办、批量设置属性、统计标签使用量。前提只有一个——Obsidian 必须处于打开状态。它对插件开发者也有用重载插件、抓报错、截图验证、查控制台日志一条命令都不用你敲。defuddle 技能是个省 token 的小工具。把网页 URL 丢给 AI它会先用 Defuddle 把导航栏、广告这些噪音剥掉只留正文转成 Markdown再去做总结或入库。网页里的.md文件则跳过这一步直接读。4 个高频场景照着说就能用装好之后你只需要用大白话提需求不用自己写语法。建一篇规范笔记帮我新建一篇读书笔记加上作者、标签两个属性正文里给相关概念留 wikilink 占位结尾加一个 tip callout。生成一张主题画布把下面这段想法做成画布中心一个主节点四周放三个支撑点并连线。搭一个看板帮我建一个.base任务看板按 status 分组加一列距截止还有几天。批量改属性把库里所有 status 还是 todo 的笔记都改成 done。——这类操作走 CLI 技能AI 会自己拼好命令。建议第一次就用前两个场景试水产物直观对不对一眼能看出来。AI 写坏文件时的排查顺序技能文档里其实自带 Troubleshooting 段落AI 会照着查。常见坑和对应解法给你列一份备查现象原因解法.base打开报 YAML 错误字符串里带冒号、方括号等特殊字符没加引号用引号把整个字符串包起来公式里双重引号打架公式内部用了双引号外层又套双引号外层统一换单引号包裹日期计算报错日期相减得到的是 Duration不能直接取整或做除法先取.days字段再对数字操作公式在部分笔记上报错某篇笔记压根没有该属性用if()先判空画布节点串位、连线消失新建节点时 ID 撞车或连线引用了不存在的节点生成前先检查已有 ID连线两端必须指向真实节点画布文本里出现字面的\nJSON 字符串里写错了换行符换行一律用转义后的\n排查思路按这个顺序走先确认文件本身是合法 YAML / JSON → 再核对 ID 和引用是否对得上 → 最后丢进 Obsidian 里打开看一眼实际渲染。函数层面的完整清单在 FUNCTIONS_REFERENCE.md。装完之后按这条路线跑一遍选一种方式把技能包装上重启你的 Agent 工具让 AI 写一篇带属性和 wikilink 的笔记在 Obsidian 里核对渲染让它生成一个.base视图任务追踪是好起点打开确认视图正常显示挑一个你感兴趣的主题让 AI 产出一张.canvas画布打开 Obsidian 后试试 CLI 场景统计标签 Top 10、批量设置属性以后每次遇到 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考