快速集成 obsidian-skills 指南

快速集成 obsidian-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-skills

让 AI 代理去整理你 Obsidian 库里的几篇笔记，它通常会老实巴交地写出一份普通 Markdown：wikilink 被换成普通链接，frontmatter 属性写得七零八落，.base数据库和.canvas画布文件则完全不在它的认知范围内。obsidian-skills 解决的就是这个问题——它是一套开源的 Agent Skills，教会 AI 代理正确读写 Obsidian 的各类文件，装上之后，OpenCode 等兼容 skills 规范的代理就能直接上手干活。

这套技能到底是什么

obsidian-skills 遵循 Agent Skills 规范，每个技能就是一个带描述和参考文档的SKILL.md文件，覆盖 Obsidian 用户日常打交道的五类格式：Flavored Markdown、Bases 数据库、JSON Canvas、官方 CLI，以及网页正文提取工具 Defuddle。和通用 Markdown 写法不同，它只补充 Obsidian 特有语法这一层——[[wikilinks]]、![[嵌入]]、callout、properties，以及.base和.canvas的文件结构——标准 Markdown 部分默认代理已经会。同一套技能也能用在 Claude Code、Codex 等其他 skills 兼容的代理上，写一次到处生效。

三步完成初始配置

第一步：克隆完整仓库到 OpenCode 的技能目录：

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

执行完你会看到克隆目录里有一个skills/子目录，下面分出 5 个子文件夹，各自带着一份 SKILL.md。

第二步：重启 OpenCode。不需要改任何配置文件，OpenCode 会自动发现~/.opencode/skills/下的所有 SKILL.md。

第三步：验证。让 OpenCode 新建一篇"带属性和内部链接"的笔记。库里出现一篇 frontmatter 完整、[[wikilinks]]格式正确的笔记，说明 obsidian-skills 集成已经跑通。

能力拆解

把笔记和画布写成 Obsidian 能认的格式

加载 obsidian-markdown 技能后，代理就分得清场景：库内链接用[[wikilinks]]（重命名时自动跟随），外部 URL 才用标准链接；嵌入用![[...]]；标注框用> [!note]这类语法。json-canvas 技能则负责.canvas文件：它会为每个节点生成唯一 ID、错开坐标避免重叠、用 fromNode/toNode 连边，并在输出前校验 JSON 是否合法。你只需要说"把这几篇笔记整理成一张思维导图"，它能交付一个打开就能用的画布文件。

把笔记库变成可检索的数据库视图

笔记多了以后，靠手动翻找聚合会非常累。这时候可以让 OpenCode 写一个.base文件：用 filters 按标签、属性或日期圈定范围，用 formulas 定义计算字段，再配 table、cards、list 等视图。技能目录里附了完整的函数参考，日期格式化、聚合统计都有现成的函数，代理写公式时可以照着查，不容易出语法错误。

从网页到干净笔记的一键转化

收藏网页文章进库之前，代理会先用 Defuddle 把页面提炼成纯正文，去掉导航、广告和侧栏，省下的 token 相当可观：

defuddle parse <url> --md

输出是一段干净的 Markdown，直接就能丢进库里。如果源文件本身就是.md，它会跳过这一步直接读取，不会多此一举。

实战中的几个坑

最容易踩的是目录结构。只把内层的skills/文件夹拷进技能目录是不行的，那样路径会变成skills/obsidian-skills/skills/<名称>/SKILL.md，OpenCode 的自动发现机制找不到它——这也是官方文档明确要求克隆整个仓库的原因。其次是依赖关系：obsidian-cli 技能需要一个正在运行的 Obsidian 实例，应用没打开时命令不会生效；Defuddle 是独立的 CLI，需要另外用 npm 安装。技能库本身在持续更新，执行git pull并重启 OpenCode 后，新技能才会生效：

cd ~/.opencode/skills/obsidian-skills && git pull

资源与后续

• 安装细节与多代理配置：README.md
• Markdown 属性、嵌入、callout 参考：skills/obsidian-markdown/references/
• 画布结构示例：skills/json-canvas/references/EXAMPLES.md
• Bases 函数大全：skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md

跑通集成之后，可以给它派个真任务试试：让它在库里建一个 Bases 视图，列出所有打了#待办标签的笔记，再按创建日期倒序排列。

【免费下载链接】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