让 AI 替你管知识库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双链、callout、属性块全丢了拿到库里根本没法用。obsidian-skills 就是来解决这个问题的——它是一套符合 Agent Skills 规范的技能包教会 Claude 等 AI 助手正确操作 Obsidian覆盖 Obsidian 风味 Markdown、Bases 数据库、JSON Canvas 画布、官方命令行以及网页内容提取五大核心功能让你用自然语言就能完成笔记创作、数据整理和自动化维护。为什么 AI 需要专门学 ObsidianObsidian 并不是普通 Markdown 软件。它在 CommonMark 之上扩展了一整套私有语法[[双链]]、![[嵌入]]、 [!note]标注、YAML frontmatter 属性、#嵌套/标签等等。通用大模型没有见过这些写法生成的内容要么语法错误要么直接退化成普通链接知识库的关联结构就被破坏了。obsidian-skills 的思路不是让 AI猜而是把每种文件格式的规范、工作流和校验清单写成技能文档AI 在动手前先读规范再产出最后还会自检。这也是它遵循 Agent Skills 开放标准的原因同一套技能可以被 Claude Code、Codex、OpenCode 等任何兼容的 Agent 使用不必绑定特定产品。三步完成安装配置根据你使用的 Agent安装方式略有不同整体都很轻插件市场安装Claude Code 等支持 marketplace 的客户端执行/plugin marketplace add kepano/obsidian-skills然后/plugin install obsidianobsidian-skills。npx 方式运行npx skills add 仓库地址自动拉取全部技能。手动放置把技能放进各 Agent 约定的目录即可——Claude Code将仓库内容放入 Obsidian 库根目录的.claude文件夹Codex把skills/目录复制到~/.codex/skillsOpenCode需要克隆整个仓库到~/.opencode/skills/obsidian-skills注意不能只拷内层的skills/文件夹保持skills/技能名/SKILL.md的目录结构OpenCode 会自动发现所有技能文件重启后生效手动方式需要的仓库地址是https://gitcode.com/GitHub_Trending/ob/obsidian-skills。场景一让 AI 写出 Obsidian 原生笔记obsidian-markdown技能让 AI 掌握 Obsidian 风味 Markdown 的全部扩展语法规范细节见 skills/obsidian-markdown/SKILL.md。它教给 AI 的关键约定包括库内引用一律用 wikilinkObsidian 会自动追踪重命名外部 URL 才用标准 Markdown 链接用![[...]]嵌入整篇笔记、某个小节、图片或 PDF 的指定页用 [!type]创建 note、tip、warning、todo 等多种 callout支持折叠frontmatter 里正确书写 tags、aliases、cssclasses 等属性还支持嵌套标签、%%隐藏注释%%、高亮语法、LaTeX 公式、Mermaid 图表和脚注。技能内置了六步写作工作流加属性 → 写正文 → 建立双链 → 嵌入引用 → 高亮关键信息 → 检查渲染效果。你只需要说帮我把这篇会议记录整理成笔记AI 就会按这套流程产出能直接在 Obsidian 阅读视图中正常显示的文件。更细的语法表在 references/PROPERTIES.md、references/EMBEDS.md 和 references/CALLOUTS.md 里都有。场景二用 Bases 给笔记建动态数据库笔记多了之后翻文件夹找东西很痛苦。obsidian-bases技能见 skills/obsidian-bases/SKILL.md让 AI 帮你创建.base文件——本质上是用 YAML 定义的一个动态视图可以按标签、文件夹、属性、日期筛选笔记再配表格、卡片、列表、地图四种视图类型。它能做的事情比想象中多公式计算给笔记加上formula计算属性比如根据到期日算还剩几天、根据字数估算阅读时长、按优先级显示红黄绿标识聚合统计对列做 Sum、Average、Median、Unique 等汇总表尾自动出统计行分组与排序按状态分组、按日期排序、限制显示条数技能文档里附带了三个可直接套用的模板任务跟踪表Active/Completed 双视图 逾期检测、阅读清单卡片式书架 待读表格、每日笔记索引按日期正则筛选 词数估算。你只需要描述需求AI 会生成合法的 YAML 并自动验证。完整的函数库参考在 references/FUNCTIONS_REFERENCE.md涵盖日期、字符串、数字、列表等全部类型。另外Base 可以像嵌入图片一样嵌进笔记![[MyBase.base]]嵌入整个 Base![[MyBase.base#View Name]]只嵌入指定视图。场景三用 Canvas 把知识关系画出来脑中有想法但笔记之间到底怎么关联json-canvas技能见 skills/json-canvas/SKILL.md让 AI 直接创建和编辑.canvas文件把思维导图、流程图、项目看板画出来。画布由节点和连线两部分组成。AI 需要掌握的核心规则有四种节点类型文本、文件、外链、分组各自有不同的必填字段节点 ID 必须是 16 位十六进制字符串且全局唯一连线通过fromNode/toNode引用节点 ID可设置箭头方向和标签文字颜色支持 6 种预设或任意十六进制色值布局上节点之间留 50–100px 间距、对齐 10/20 的网格更整洁。最关键的是技能内置了一份八项校验清单ID 是否唯一、连线是否指向存在的节点、JSON 是否合法等。每次编辑完成后 AI 都会自查避免画布文件损坏。思维导图、项目看板、研究画布等完整示例在 references/EXAMPLES.md 中可以直接参考。场景四通过命令行批量操作整个库手工整理几百篇笔记不现实obsidian-cli技能见 skills/obsidian-cli/SKILL.md让 AI 通过官方obsidian命令行与正在运行的 Obsidian 实例交互实现批量操作。日常库管理命令覆盖了绝大多数需求obsidian read fileMy Note obsidian create nameNew Note content# Hello templateTemplate silent obsidian search querysearch term limit10 obsidian property:set namestatus valuedone fileMy Note obsidian tasks daily todo obsidian backlinks fileMy Note几个实用细节不带文件参数时默认操作当前活动文件file按双链方式解析只需名字path用库根起的精确路径多开库时用vault指定目标库加silent可避免文件被弹出打开。对插件和主题开发者这个技能的价值更大它定义了一个完整的开发-调试循环——改代码 →plugin:reload重载 →dev:errors查报错 →dev:screenshot截图验证 →dev:console看日志还能eval直接在应用里执行 JS、用dev:dom检查 DOM。AI 可以替你盯着整个调试过程。场景五抓网页内容还能省 token给 AI 喂网页资料时直接抓取 HTML 会混进大量导航栏和广告既干扰理解又浪费 token。defuddle技能见 skills/defuddle/SKILL.md解决这个问题defuddle parse url --md它只提取正文并输出干净的 Markdown还能用-p title、-p description单独取元数据用-o直接存成文件。技能约定只要是普通网页链接优先用 Defuddle 而不是通用抓取只有 URL 本身就是.md文件时才跳过它。装一下npm install -g defuddle就能用。三个新手容易踩的坑技能文档把最常见的错误都写成了检查项这里挑三个最值得记住的Bases 里的 YAML 引号公式内含双引号时整个公式要用单引号包住比如if(done, Yes, No)显示名里含冒号等特殊字符也必须加引号否则整个文件报 YAML 错误。日期运算要先取字段Bases 中两个日期相减得到的是 Duration 类型而不是数字直接.round()会报错正确写法是先取.days再操作(now() - file.ctime).days.round(0)。另外属性可能不存在记得用if()做空值保护。画布换行符文本节点的换行必须写 JSON 转义的\n写成字面量\\n会在画布上显示成反斜杠加字母 n。地图视图还需要配合 Maps 社区插件才能渲染提前装好可以避免文件没问题但视图空白的困惑。这套技能适合谁如果你只是轻度用户最常用的是前两个场景让 AI 按 Obsidian 规范写笔记、建一个任务或书单 Base收益立竿见影。重度用户和知识工作者会再用到画布和 CLI把可视化梳理和批量维护也交给 AI。而开发 Obsidian 插件或主题的人obsidian-cli提供的那套重载-报错-截图调试循环基本等于给 AI 配了一个自动化的测试环境。技能文档本身就是最好的学习材料——每个 SKILL.md 都按工作流 → 语法 → 示例 → 排错组织即使你不接 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-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 让 AI 替你管知识库：obsidian-skills 五大技能完整指南
让 AI 替你管知识库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双链、callout、属性块全丢了拿到库里根本没法用。obsidian-skills 就是来解决这个问题的——它是一套符合 Agent Skills 规范的技能包教会 Claude 等 AI 助手正确操作 Obsidian覆盖 Obsidian 风味 Markdown、Bases 数据库、JSON Canvas 画布、官方命令行以及网页内容提取五大核心功能让你用自然语言就能完成笔记创作、数据整理和自动化维护。为什么 AI 需要专门学 ObsidianObsidian 并不是普通 Markdown 软件。它在 CommonMark 之上扩展了一整套私有语法[[双链]]、![[嵌入]]、 [!note]标注、YAML frontmatter 属性、#嵌套/标签等等。通用大模型没有见过这些写法生成的内容要么语法错误要么直接退化成普通链接知识库的关联结构就被破坏了。obsidian-skills 的思路不是让 AI猜而是把每种文件格式的规范、工作流和校验清单写成技能文档AI 在动手前先读规范再产出最后还会自检。这也是它遵循 Agent Skills 开放标准的原因同一套技能可以被 Claude Code、Codex、OpenCode 等任何兼容的 Agent 使用不必绑定特定产品。三步完成安装配置根据你使用的 Agent安装方式略有不同整体都很轻插件市场安装Claude Code 等支持 marketplace 的客户端执行/plugin marketplace add kepano/obsidian-skills然后/plugin install obsidianobsidian-skills。npx 方式运行npx skills add 仓库地址自动拉取全部技能。手动放置把技能放进各 Agent 约定的目录即可——Claude Code将仓库内容放入 Obsidian 库根目录的.claude文件夹Codex把skills/目录复制到~/.codex/skillsOpenCode需要克隆整个仓库到~/.opencode/skills/obsidian-skills注意不能只拷内层的skills/文件夹保持skills/技能名/SKILL.md的目录结构OpenCode 会自动发现所有技能文件重启后生效手动方式需要的仓库地址是https://gitcode.com/GitHub_Trending/ob/obsidian-skills。场景一让 AI 写出 Obsidian 原生笔记obsidian-markdown技能让 AI 掌握 Obsidian 风味 Markdown 的全部扩展语法规范细节见 skills/obsidian-markdown/SKILL.md。它教给 AI 的关键约定包括库内引用一律用 wikilinkObsidian 会自动追踪重命名外部 URL 才用标准 Markdown 链接用![[...]]嵌入整篇笔记、某个小节、图片或 PDF 的指定页用 [!type]创建 note、tip、warning、todo 等多种 callout支持折叠frontmatter 里正确书写 tags、aliases、cssclasses 等属性还支持嵌套标签、%%隐藏注释%%、高亮语法、LaTeX 公式、Mermaid 图表和脚注。技能内置了六步写作工作流加属性 → 写正文 → 建立双链 → 嵌入引用 → 高亮关键信息 → 检查渲染效果。你只需要说帮我把这篇会议记录整理成笔记AI 就会按这套流程产出能直接在 Obsidian 阅读视图中正常显示的文件。更细的语法表在 references/PROPERTIES.md、references/EMBEDS.md 和 references/CALLOUTS.md 里都有。场景二用 Bases 给笔记建动态数据库笔记多了之后翻文件夹找东西很痛苦。obsidian-bases技能见 skills/obsidian-bases/SKILL.md让 AI 帮你创建.base文件——本质上是用 YAML 定义的一个动态视图可以按标签、文件夹、属性、日期筛选笔记再配表格、卡片、列表、地图四种视图类型。它能做的事情比想象中多公式计算给笔记加上formula计算属性比如根据到期日算还剩几天、根据字数估算阅读时长、按优先级显示红黄绿标识聚合统计对列做 Sum、Average、Median、Unique 等汇总表尾自动出统计行分组与排序按状态分组、按日期排序、限制显示条数技能文档里附带了三个可直接套用的模板任务跟踪表Active/Completed 双视图 逾期检测、阅读清单卡片式书架 待读表格、每日笔记索引按日期正则筛选 词数估算。你只需要描述需求AI 会生成合法的 YAML 并自动验证。完整的函数库参考在 references/FUNCTIONS_REFERENCE.md涵盖日期、字符串、数字、列表等全部类型。另外Base 可以像嵌入图片一样嵌进笔记![[MyBase.base]]嵌入整个 Base![[MyBase.base#View Name]]只嵌入指定视图。场景三用 Canvas 把知识关系画出来脑中有想法但笔记之间到底怎么关联json-canvas技能见 skills/json-canvas/SKILL.md让 AI 直接创建和编辑.canvas文件把思维导图、流程图、项目看板画出来。画布由节点和连线两部分组成。AI 需要掌握的核心规则有四种节点类型文本、文件、外链、分组各自有不同的必填字段节点 ID 必须是 16 位十六进制字符串且全局唯一连线通过fromNode/toNode引用节点 ID可设置箭头方向和标签文字颜色支持 6 种预设或任意十六进制色值布局上节点之间留 50–100px 间距、对齐 10/20 的网格更整洁。最关键的是技能内置了一份八项校验清单ID 是否唯一、连线是否指向存在的节点、JSON 是否合法等。每次编辑完成后 AI 都会自查避免画布文件损坏。思维导图、项目看板、研究画布等完整示例在 references/EXAMPLES.md 中可以直接参考。场景四通过命令行批量操作整个库手工整理几百篇笔记不现实obsidian-cli技能见 skills/obsidian-cli/SKILL.md让 AI 通过官方obsidian命令行与正在运行的 Obsidian 实例交互实现批量操作。日常库管理命令覆盖了绝大多数需求obsidian read fileMy Note obsidian create nameNew Note content# Hello templateTemplate silent obsidian search querysearch term limit10 obsidian property:set namestatus valuedone fileMy Note obsidian tasks daily todo obsidian backlinks fileMy Note几个实用细节不带文件参数时默认操作当前活动文件file按双链方式解析只需名字path用库根起的精确路径多开库时用vault指定目标库加silent可避免文件被弹出打开。对插件和主题开发者这个技能的价值更大它定义了一个完整的开发-调试循环——改代码 →plugin:reload重载 →dev:errors查报错 →dev:screenshot截图验证 →dev:console看日志还能eval直接在应用里执行 JS、用dev:dom检查 DOM。AI 可以替你盯着整个调试过程。场景五抓网页内容还能省 token给 AI 喂网页资料时直接抓取 HTML 会混进大量导航栏和广告既干扰理解又浪费 token。defuddle技能见 skills/defuddle/SKILL.md解决这个问题defuddle parse url --md它只提取正文并输出干净的 Markdown还能用-p title、-p description单独取元数据用-o直接存成文件。技能约定只要是普通网页链接优先用 Defuddle 而不是通用抓取只有 URL 本身就是.md文件时才跳过它。装一下npm install -g defuddle就能用。三个新手容易踩的坑技能文档把最常见的错误都写成了检查项这里挑三个最值得记住的Bases 里的 YAML 引号公式内含双引号时整个公式要用单引号包住比如if(done, Yes, No)显示名里含冒号等特殊字符也必须加引号否则整个文件报 YAML 错误。日期运算要先取字段Bases 中两个日期相减得到的是 Duration 类型而不是数字直接.round()会报错正确写法是先取.days再操作(now() - file.ctime).days.round(0)。另外属性可能不存在记得用if()做空值保护。画布换行符文本节点的换行必须写 JSON 转义的\n写成字面量\\n会在画布上显示成反斜杠加字母 n。地图视图还需要配合 Maps 社区插件才能渲染提前装好可以避免文件没问题但视图空白的困惑。这套技能适合谁如果你只是轻度用户最常用的是前两个场景让 AI 按 Obsidian 规范写笔记、建一个任务或书单 Base收益立竿见影。重度用户和知识工作者会再用到画布和 CLI把可视化梳理和批量维护也交给 AI。而开发 Obsidian 插件或主题的人obsidian-cli提供的那套重载-报错-截图调试循环基本等于给 AI 配了一个自动化的测试环境。技能文档本身就是最好的学习材料——每个 SKILL.md 都按工作流 → 语法 → 示例 → 排错组织即使你不接 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-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考