快速集成 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 库里的几篇笔记它通常会老实巴交地写出一份普通 Markdownwikilink 被换成普通链接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.mdOpenCode 的自动发现机制找不到它——这也是官方文档明确要求克隆整个仓库的原因。其次是依赖关系obsidian-cli 技能需要一个正在运行的 Obsidian 实例应用没打开时命令不会生效Defuddle 是独立的 CLI需要另外用 npm 安装。技能库本身在持续更新执行git pull并重启 OpenCode 后新技能才会生效cd ~/.opencode/skills/obsidian-skills git pull资源与后续安装细节与多代理配置README.mdMarkdown 属性、嵌入、callout 参考skills/obsidian-markdown/references/画布结构示例skills/json-canvas/references/EXAMPLES.mdBases 函数大全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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考