
给 AI 助手装上 Obsidian 技能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-skillsobsidian-skills 是一套给 AI 助手用的 Obsidian 技能包把它装进 Claude Code、Codex 或 OpenCodeAI 就能按 Obsidian 的专有规则创建笔记、Bases 表格视图和 JSON Canvas 白板。你只管用一句话提需求语法细节交给 AI 处理。它是什么适合谁这不是一个插件也没有需要运行的服务仓库里只有 5 个技能目录每个目录一个 SKILL.md 文件加若干参考文档AI 助手读到这些文档就学会了 Obsidian 的写法。适合同时使用 Obsidian 和命令行 AI 助手的人不想手敲[[维基链接]]、标注框、.base这些专有语法或者想让 AI 批量整理整个库的时候。五个技能各管一件事覆盖笔记语法skills/obsidian-markdown/、数据库视图skills/obsidian-bases/、画布白板skills/json-canvas/、命令行操作skills/obsidian-cli/和网页正文提取skills/defuddle/。5 分钟装好跑通第一条指令确认你的 AI 助手支持 Agent Skills 格式Claude Code、Codex、OpenCode 都可以技能文件遵循统一的技能规范三种助手通用。把技能放进助手约定的目录Claude Code 用户把仓库内容复制到 Obsidian 库根目录的.claude文件夹Codex 用户把skills/目录复制到~/.codex/skills。OpenCode 用户克隆整个仓库注意必须克隆完整仓库而不是只拷skills/子目录# OpenCode克隆整个仓库到技能目录 git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills重启 AI 助手技能会自动被发现不需要改任何配置文件。验证说一句帮我建一篇带标注框和维基链接的会议笔记再到 Obsidian 阅读视图里看渲染是否正常。怎么让 AI 写出的笔记带上维基链接和标注框想让笔记互相链接、用标注框突出重点时直接提需求就行比如建一篇项目笔记用[!warning]标注框提醒截止日期并链接到已有的《需求文档》。AI 会按 skills/obsidian-markdown/SKILL.md 里的流程来先写 frontmatter 属性再写正文用[[笔记名]]建库内链接用![[文件]]嵌入图片或别的笔记。容易踩的坑有两个库内笔记一律用维基链接重命名笔记时 Obsidian 会自动跟着改外部网址才用普通 Markdown 链接标注框类型不止[!note]一种完整列表见 references/CALLOUTS.md属性类型见 references/PROPERTIES.md。怎么把一堆笔记变成可筛选的表格想把散落各处的任务笔记、读书卡片变成一张能按状态、标签筛选的表格就让 AI 写一个.base文件Obsidian Bases本质是描述数据库视图的 YAML。比如把带 task 标签的笔记做成表格视图只显示没完成的按状态分组。AI 会在 skills/obsidian-bases/SKILL.md 的指引下手写 filters过滤条件、formulas计算字段和 views视图三段。两个高频坑字符串里带冒号、方括号等 YAML 特殊字符时必须加引号否则整个文件报 YAML 错误两个日期相减得到的是时长而不是数字要算天数必须取.days字段。函数细节查 references/FUNCTIONS_REFERENCE.md。怎么让 AI 画出概念图和流程图想让读书笔记变成一张可交互的图就让 AI 生成.canvas文件JSON Canvas一种用节点和连线描述白板的开放格式。把这段内容画成一张概念图主概念居中分支用不同颜色这类指令即可。AI 会生成 text 文本节点、group 分组节点和 edges 连线完整示例见 references/EXAMPLES.md。坑在 JSON 细节上节点文本里换行必须写\n写成\\n会在画布上显示成两个可见字符每个节点和连线的id必须是唯一的 16 位十六进制串连线的fromNode/toNode必须指向已存在的节点错一个整个文件都打不开。怎么让 AI 直接操作正在运行的 Obsidian前三个技能只是写文件skills/obsidian-cli/SKILL.md 让 AI 通过obsidian命令行跟运行中的 Obsidian 实例对话搜索、建笔记、追加内容、改属性、查反链比如obsidian search query搜索词或obsidian daily:append content- [ ] 新任务把任务写进每日笔记。前提是 Obsidian 必须处于打开状态命令才会生效参数值带空格要加引号开多个库时用vault库名作为第一个参数指定目标库。做插件或主题开发时它还有plugin:reload、dev:screenshot、dev:console这类调试命令改完代码不用手动重启插件。怎么把网页正文变成干净的 Markdown要把一篇文章、一段在线文档的内容交给 AI 分析仓库里的 skills/defuddle/SKILL.md 指定用 Defuddle 工具defuddle parse 网址 --md会去掉导航栏、广告和页脚只留正文输出成 Markdown省下的 token 留给真正要分析的内容。两个注意点网址以.md结尾的不需要走这一步直接读就行工具没装的话先执行npm install -g defuddle。容易踩的坑OpenCode 只复制了skills/子目录重启后技能一个都不生效。 对策克隆完整仓库保证路径是skills/obsidian-skills/skills/技能名/SKILL.md。装完技能AI 写出来的还是普通 Markdown没有维基链接和标注框。 对策先确认技能文件放进了助手对应的目录再重启助手让它重新发现技能。.base文件打开直接报 YAML 语法错误。 对策检查有无引号包裹的冒号或方括号公式里含双引号时用单引号把整个公式包起来。Bases 公式里算两个日期相差几天时报错。 对策日期相减返回的是 Duration 类型必须取.days字段才能参与数值运算属性可能为空时再用if()包一层兜底。Canvas 文件能打开但节点里的换行变成了可见的\n字符。 对策JSON 字符串中的换行只写一个反斜杠加 n不要写\\n。仓库本身没有安装脚本和依赖技能文件放对位置就能用。现在就打开你的 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),仅供参考