Obsidian-skills 技能包指南：让 AI 助手替你写笔记、Bases 和 Canvas

Obsidian-skills 技能包指南让 AI 助手替你写笔记、Bases 和 Canvas【免费下载链接】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 是一套面向 Obsidian 用户的 AI 技能包解决的是这类人的具体问题你用 Claude Code、Codex 或 OpenCode 这类 AI 代理干活同时用 Obsidian 管理知识库但代理不懂 Obsidian 的私有语法写出来的笔记没有维基链接、Bases 视图也建不起来。装上这套技能后AI 可以直接创建 Obsidian Flavored Markdown 笔记、Bases 数据库视图和 JSON Canvas 思维导图文件。技能遵循开放的 Agent Skills 规范不绑定特定厂商的代理。全文从安装讲起再拆解五个技能各自能替你完成什么任务最后给三个可照做的实战场景和常见报错的排查方法。跟着做五分钟内可以让代理产出第一篇笔记和第一个数据库视图。五分钟上手把 Obsidian 技能装到对应代理仓库包含 5 个技能分别对应笔记语法、Bases、Canvas、命令行操作和网页提取。安装就是一次 clone再按你用的代理放到不同位置git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills代理放置位置注意点Claude Code仓库内容复制到 vault 根目录的.claude/放在 Claude Code 实际工作的文件夹下Codex把skills/目录复制到~/.codex/skills保持内部目录结构不变OpenCode整个仓库 clone 到~/.opencode/skills/obsidian-skills不要只复制内部的skills/目录OpenCode 会自动发现~/.opencode/skills/下所有的 SKILL.md不需要改任何配置文件重启代理后生效。自检方法让代理「建一条测试笔记包含一个维基链接和一个标注框」。生成的内容应该出现[[笔记名]]和 [!note]语法把它拷进 Obsidian 的阅读视图能正常渲染说明技能包已经工作。核心能力拆解代理能替你完成什么写会 Obsidian 语法的笔记obsidian-markdown 技能让代理分清 Obsidian 扩展语法和标准 Markdown 的边界vault 内跳转用[[wikilink]]Obsidian 会自动跟踪笔记重命名外部 URL 才用标准 Markdown 链接维基链接前加!就是嵌入可以嵌整篇笔记、指定章节、图片或 PDF 的第 3 页 [!type]是标注框。完整语法清单在 skills/obsidian-markdown/SKILL.md标注框、嵌入、属性各有一份独立参考文档。把一堆笔记变成数据库视图obsidian-bases 技能让代理写.base文件。Base 是 YAMLfilters决定哪些笔记入选formulas定义计算列views选展示形式table、cards、list、map。典型结构长这样filters: and: - file.hasTag(task) - status ! done formulas: days_until_due: if(due, (date(due) - today()).days, ) views: - type: table order: [file.name, status, due, formula.days_until_due] summaries: formula.days_until_due: Average这个 base 只收录打了 task 标签且未完成的笔记多出一列公式计算的「距截止天数」表格底部给出平均值。函数写法查 references/FUNCTIONS_REFERENCE.md 即可不用背。在 Canvas 上画可视化知识图谱json-canvas 技能处理.canvas文件。Canvas 是一个含nodes和edges两个数组的 JSON节点分 text、file、link、group 四种ID 用 16 位十六进制串节点之间留 50-100px 间距颜色取预设 1 到 6。技能自带校验清单生成后代理会自查 ID 是否重复、边的fromNode/toNode是否指向存在的节点避免画出一张断线的图。思维导图、看板、流程图的完整样例在 references/EXAMPLES.md。用命令行操作运行中的 Obsidianobsidian-cli 技能教代理通过obsidian命令与正在运行的 Obsidian 实例交互创建和追加笔记、全库搜索、读写属性、操作每日笔记、查反链。你可以在终端直接跑obsidian search query关键词 limit10感受它的能力。注意前提Obsidian 必须处于打开状态。真实场景实战自动归位的阅读清单场景你有几十篇读书笔记每篇 frontmatter 里都写着 status 属性想看一张随时更新的清单。做法让代理建一个 base全局过滤file.hasTag(book)或file.hasTag(article)的笔记cards 视图展示封面、作者和状态图标公式在读显示 、读完显示 ✅再单开一个 table 视图只显示 to-read 的条目。最后用![[Reading.base]]把 base 嵌入一个固定入口笔记。效果把某本书的 status 改成 done卡片立刻从「在读」挪到「已完读」分组不用手动整理预估阅读时长可以直接用pages * 2这类公式算出来。插件开发调试循环场景你在开发 Obsidian 插件每改一次代码都要手动重载插件、再打开开发者工具看报错。做法obsidian-cli 技能提供固定四步循环——obsidian plugin:reload idmy-plugin obsidian dev:errors obsidian dev:screenshot pathscreenshot.png obsidian dev:console levelerror重载、查错、截图验证界面、看控制台日志另可用obsidian eval codeapp.vault.getFiles().length直接在应用上下文跑 JS。效果改代码到验证的完整循环都在代理对话里完成截图文件还能回喂给 AI 让它判断 UI 渲染是否正确不再来回切编辑器和浏览器。网页长文存进知识库场景想把一篇技术文章收集进库并让 AI 做摘要但网页 HTML 里大量导航和广告会浪费 token。做法先让代理执行defuddle parse url --md -o content.mddefuddle 是独立 CLI需先npm install -g defuddle把导航、广告、侧边栏剥掉只留正文 Markdown再用 obsidian-markdown 技能生成一张文献卡片标题、来源、摘要齐备并嵌入原文。效果AI 读到的只有标题、正文和列表摘要不再夹带「相关阅读」之类的噪音卡片里保留原文链接方便回溯。避坑指南高频报错与排查OpenCode 识别不到技能→ 只复制了内部的skills/目录结构不对 → 整个仓库 clone 到~/.opencode/skills/obsidian-skills重启代理。.base 文件报 YAML 错误→ 公式内含双引号、外层又用双引号包裹 → 公式整体改用单引号如if(done, Yes, No)。日期公式报错→ 两个日期相减得到的是 Duration 而不是数字 → 先取.days字段再做运算如(date(due) - today()).days。Canvas 节点里出现字面\n字符→ JSON 里把换行写成了\\n→ 换行符应写成\n。obsidian 命令不生效→ Obsidian 没打开 → CLI 只能指向运行中的实例先启动应用。收尾从哪一步开始技能本身就是 Markdown 文件行为不符合预期时直接打开对应的 SKILL.md 看代理被教了什么改技能比改提示词更直接。所有产物.md、.base、.canvas都是纯文本天然适合用 Git 做版本管理。正式干活前先用自检流程跑一遍「维基链接 标注框」确认技能链是通的。推荐顺序先让代理建几条带标签和维基链接的笔记再让它写一个 base 表格视图最后有余力时画一张 Canvas 知识图谱。【免费下载链接】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），仅供参考