1 行命令装好 obsidian-skills教 AI 读写 Obsidian 的完整教程【免费下载链接】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 是一套开源 Agent 技能包让 Claude Code、Codex 等 AI 助手学会读写 Obsidian 笔记、Bases 数据库与 Canvas 画布解决 AI 不懂 Obsidian 私有语法、容易改坏知识库的问题。 明确项目定位给 AI 一份 Obsidian 操作手册obsidian-skills 不是插件而是一组遵循 Agent Skills 规范的技能文件任何兼容该规范的客户端都能加载。机制很直接每个技能由一份 SKILL.md 主文件和若干参考文档组成AI 接到任务后照着文件里的语法规则和工作流操作 Vault。说白了它把 wikilinks、callouts、frontmatter 这些 Obsidian 私有写法写成模型能直接执行的说明书。 对号入座三类知识库任务可以直接交给 AI批量补全笔记元数据。一百多条会议纪要缺 frontmatter、缺标签、彼此不链接。让 AI 给每篇统一加 title、tags、status再用 wikilinks 把相关会议串起来——规则明确、重复度高的活最适合外包。把散落笔记变成数据库。读书笔记散在十几个文件里你想按状态筛选、按来源分组。AI 可以生成 .base 数据库文件做出表格和卡片两种视图还能用公式算出阅读进度。网页进库并建图谱。收藏的文章要先清洗再入库用 Defuddle 提取干净正文存成笔记再把关键概念画进 Canvas 关系图。拆解核心能力笔记语法、数据库、画布与命令行用 AI 写对 Obsidian 风味 Markdownobsidian-markdown 技能覆盖 wikilinks、嵌入、callouts、属性、标签等私有语法并规定库内链接用 [[wikilink]]、外部 URL 才用普通链接。一个例子批量给新建笔记套用属性模板属性类型规则见 skills/obsidian-markdown/references/PROPERTIES.md。另一个是修复断链AI 先定位引用位置再重建指向。配套的 defuddle 技能做网页清洗defuddle parse url --md -o content.md一行命令去掉导航和广告只留正文省 token 也省时间。用 Bases 给笔记建可筛选的数据库视图obsidian-bases 技能让 AI 会写 .base 文件filters 圈定范围formulas 定义计算属性views 输出 table、cards、list、map 四种视图。例子给阅读清单建库用status reading过滤出在读书目表格视图按来源分组。函数语法查 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md。用 JSON Canvas 画知识关系图谱json-canvas 技能处理 .canvas 文件每个节点生成 16 位十六进制 ID连线必须引用已存在的节点新增节点还要避开重叠位置。例子把一篇读书笔记里的几个概念画成关系图AI 建完会校验 ID 唯一性和连线完整性。样例见 skills/json-canvas/references/EXAMPLES.md。用 Obsidian CLI 批量操作 Vaultobsidian-cli 技能教 AI 驱动运行中的 Obsidian读笔记、追加内容、改属性、查任务。例子obsidian property:set namestatus valuedone fileX一条命令更新笔记状态配合模板参数还能批量建笔记。前提是 Obsidian 处于打开状态。 从 0 到跑通一行命令完成安装与首次调用第一步安装npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills支持插件市场的客户端也可以用/plugin marketplace add kepano/obsidian-skills加/plugin install obsidianobsidian-skills两条斜杠命令完成。第二步客户端要求手动放置时按官方说明放对目录Claude Code 拷到 Vault 根目录的 .claude 文件夹Codex 把 skills/ 目录拷进 ~/.codex/skillsOpenCode 必须克隆整仓只拷内层 skills/ 文件夹会失败git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills第三步重启客户端先下一个小任务试试比如给这篇会议笔记加 frontmatter 属性并链到相关笔记跑通后再加大任务量。⚠️ 排查 obsidian-skills 常见失效问题技能没生效AI 仍写标准 Markdown。客户端不兼容 Agent Skills 规范或装完没重启。解决确认所用客户端在支持列表里重启一次再试。OpenCode 里技能完全不被发现。原因是只复制了内层 skills/ 文件夹。解决OpenCode 要求整仓克隆最终目录必须是~/.opencode/skills/obsidian-skills/skills/技能名/SKILL.md。AI 把 wikilink 写成普通链接像没触发技能。技能靠指令关键词触发。解决指令里带上Obsidian 笔记、wikilinks、callouts、frontmatter这类词。obsidian CLI 命令报错或无反应。CLI 技能操作的是运行中的 Obsidian 实例默认指向最近聚焦的 Vault。解决先打开 Obsidian多库环境把vaultMy Vault作为第一个参数。.base 文件打开报 YAML 错误。常见于带特殊字符的字符串没加引号或引用了未定义的formula.X。解决按技能内校验清单检查引号与公式定义再让 AI 修正。进阶玩法建阅读数据库与跑插件调试闭环给读书笔记建完整数据库。思路分两步先让 AI 用 markdown 技能批量给笔记补 status、source、开始日期三个属性再生成 .base——全局过滤掉已归档的表格视图按 source 分组看进度卡片视图只显示在读的书。之后每周说一句刷新阅读库视图AI 基于新属性更新即可不必重建文件。用 CLI 技能跑插件开发闭环。改完插件代码让 AI 依次执行obsidian plugin:reload idmy-plugin重载、obsidian dev:errors查错、obsidian dev:screenshot pathscreenshot.png截图验证有错就修完再重载。这个循环替代手动改—刷新—观察插件和主题开发都适用。找到下一步资料从仓库文档入手这套技能包适合已有 Vault、日常使用 Claude Code 或 Codex 等 AI 客户端的知识工作者。各技能的完整语法以仓库内各 SKILL.md 与 references 目录为准安装方式与目录结构如有变化以仓库最新 README 为准。【免费下载链接】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），仅供参考 1 行命令装好 obsidian-skills：教 AI 读写 Obsidian 的完整教程
1 行命令装好 obsidian-skills教 AI 读写 Obsidian 的完整教程【免费下载链接】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 是一套开源 Agent 技能包让 Claude Code、Codex 等 AI 助手学会读写 Obsidian 笔记、Bases 数据库与 Canvas 画布解决 AI 不懂 Obsidian 私有语法、容易改坏知识库的问题。 明确项目定位给 AI 一份 Obsidian 操作手册obsidian-skills 不是插件而是一组遵循 Agent Skills 规范的技能文件任何兼容该规范的客户端都能加载。机制很直接每个技能由一份 SKILL.md 主文件和若干参考文档组成AI 接到任务后照着文件里的语法规则和工作流操作 Vault。说白了它把 wikilinks、callouts、frontmatter 这些 Obsidian 私有写法写成模型能直接执行的说明书。 对号入座三类知识库任务可以直接交给 AI批量补全笔记元数据。一百多条会议纪要缺 frontmatter、缺标签、彼此不链接。让 AI 给每篇统一加 title、tags、status再用 wikilinks 把相关会议串起来——规则明确、重复度高的活最适合外包。把散落笔记变成数据库。读书笔记散在十几个文件里你想按状态筛选、按来源分组。AI 可以生成 .base 数据库文件做出表格和卡片两种视图还能用公式算出阅读进度。网页进库并建图谱。收藏的文章要先清洗再入库用 Defuddle 提取干净正文存成笔记再把关键概念画进 Canvas 关系图。拆解核心能力笔记语法、数据库、画布与命令行用 AI 写对 Obsidian 风味 Markdownobsidian-markdown 技能覆盖 wikilinks、嵌入、callouts、属性、标签等私有语法并规定库内链接用 [[wikilink]]、外部 URL 才用普通链接。一个例子批量给新建笔记套用属性模板属性类型规则见 skills/obsidian-markdown/references/PROPERTIES.md。另一个是修复断链AI 先定位引用位置再重建指向。配套的 defuddle 技能做网页清洗defuddle parse url --md -o content.md一行命令去掉导航和广告只留正文省 token 也省时间。用 Bases 给笔记建可筛选的数据库视图obsidian-bases 技能让 AI 会写 .base 文件filters 圈定范围formulas 定义计算属性views 输出 table、cards、list、map 四种视图。例子给阅读清单建库用status reading过滤出在读书目表格视图按来源分组。函数语法查 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md。用 JSON Canvas 画知识关系图谱json-canvas 技能处理 .canvas 文件每个节点生成 16 位十六进制 ID连线必须引用已存在的节点新增节点还要避开重叠位置。例子把一篇读书笔记里的几个概念画成关系图AI 建完会校验 ID 唯一性和连线完整性。样例见 skills/json-canvas/references/EXAMPLES.md。用 Obsidian CLI 批量操作 Vaultobsidian-cli 技能教 AI 驱动运行中的 Obsidian读笔记、追加内容、改属性、查任务。例子obsidian property:set namestatus valuedone fileX一条命令更新笔记状态配合模板参数还能批量建笔记。前提是 Obsidian 处于打开状态。 从 0 到跑通一行命令完成安装与首次调用第一步安装npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills支持插件市场的客户端也可以用/plugin marketplace add kepano/obsidian-skills加/plugin install obsidianobsidian-skills两条斜杠命令完成。第二步客户端要求手动放置时按官方说明放对目录Claude Code 拷到 Vault 根目录的 .claude 文件夹Codex 把 skills/ 目录拷进 ~/.codex/skillsOpenCode 必须克隆整仓只拷内层 skills/ 文件夹会失败git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills第三步重启客户端先下一个小任务试试比如给这篇会议笔记加 frontmatter 属性并链到相关笔记跑通后再加大任务量。⚠️ 排查 obsidian-skills 常见失效问题技能没生效AI 仍写标准 Markdown。客户端不兼容 Agent Skills 规范或装完没重启。解决确认所用客户端在支持列表里重启一次再试。OpenCode 里技能完全不被发现。原因是只复制了内层 skills/ 文件夹。解决OpenCode 要求整仓克隆最终目录必须是~/.opencode/skills/obsidian-skills/skills/技能名/SKILL.md。AI 把 wikilink 写成普通链接像没触发技能。技能靠指令关键词触发。解决指令里带上Obsidian 笔记、wikilinks、callouts、frontmatter这类词。obsidian CLI 命令报错或无反应。CLI 技能操作的是运行中的 Obsidian 实例默认指向最近聚焦的 Vault。解决先打开 Obsidian多库环境把vaultMy Vault作为第一个参数。.base 文件打开报 YAML 错误。常见于带特殊字符的字符串没加引号或引用了未定义的formula.X。解决按技能内校验清单检查引号与公式定义再让 AI 修正。进阶玩法建阅读数据库与跑插件调试闭环给读书笔记建完整数据库。思路分两步先让 AI 用 markdown 技能批量给笔记补 status、source、开始日期三个属性再生成 .base——全局过滤掉已归档的表格视图按 source 分组看进度卡片视图只显示在读的书。之后每周说一句刷新阅读库视图AI 基于新属性更新即可不必重建文件。用 CLI 技能跑插件开发闭环。改完插件代码让 AI 依次执行obsidian plugin:reload idmy-plugin重载、obsidian dev:errors查错、obsidian dev:screenshot pathscreenshot.png截图验证有错就修完再重载。这个循环替代手动改—刷新—观察插件和主题开发都适用。找到下一步资料从仓库文档入手这套技能包适合已有 Vault、日常使用 Claude Code 或 Codex 等 AI 客户端的知识工作者。各技能的完整语法以仓库内各 SKILL.md 与 references 目录为准安装方式与目录结构如有变化以仓库最新 README 为准。【免费下载链接】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），仅供参考