obsidian-skills使用指南：3步装好，让AI助手写对Obsidian笔记与画布

obsidian-skills使用指南：3步装好，让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

obsidian-skills 是一套面向 Obsidian 的免费 AI 助手技能包，配合 OpenCode 使用。装上之后，AI 能按 Obsidian 的官方规范写出 Markdown 笔记、Bases 数据库和 JSON Canvas 画布，你不用再每次口头教它语法。

🌟 手动让 AI 写 Obsidian 文件的3个常见坑

• 语法写错：让 AI 记笔记，wikilink 双括号链接经常丢，它只会写普通 Markdown 链接，重命名笔记后链接就断了
• 数据库打不开：agent 生成的 .base 文件常带 YAML 引号错误，Obsidian 直接报语法错误拒绝加载
• 画布手画费劲：.canvas 是纯 JSON，节点 ID 重复、连线指向不存在的节点，这些细节全靠你一条条核对

obsidian-skills 把这些规范打包成 agent 可直接加载的技能，让 AI 一开始就按规矩写。

📦 三步装好 obsidian-skills

1. 克隆完整仓库：把整个仓库克隆到 OpenCode 的技能目录，注意必须克隆整个仓库，不能只拷里面的 skills 文件夹。

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

2. 重启 OpenCode：不用改任何配置文件，它会自己扫描技能目录下所有 SKILL.md 文件。
3. 用一句话验证：让 agent“写一条带标注框的笔记”，它直接输出> [!tip]语法就说明技能已生效。

注意：只复制内层 skills/ 文件夹会导致目录层级缺失，OpenCode 按skills/obsidian-skills/skills/技能名/SKILL.md的结构发现技能，层级不对就找不到。

装完之后，你在 OpenCode 里说“帮我做一个阅读清单数据库”，它会直接生成一份能在 Obsidian 里打开的 .base 文件。

🚀 5个核心技能菜单

1. obsidian-markdown

处理 wikilink、嵌入、标注框和 frontmatter 属性等全套特有语法。详见 skills/obsidian-markdown。

2. obsidian-bases

创建和编辑 .base 笔记数据库，覆盖视图、过滤器、公式和汇总统计。详见 skills/obsidian-bases。

3. json-canvas

创建和编辑 .canvas 画布文件，包含节点、边、分组和连接关系。详见 skills/json-canvas。

4. obsidian-cli

通过 Obsidian CLI 读取、创建、搜索笔记并管理任务，也支持插件开发调试。详见 skills/obsidian-cli。

5. defuddle

从网页提取干净的 Markdown，去掉导航和广告，节省 token 消耗。详见 skills/defuddle。

💡 3个实战场景

生成带属性的会议纪要

• 属性自动补齐：标题、日期、tags 由 agent 按规范写入 frontmatter
• wikilink 串联笔记：内部链接用双括号写法，笔记改名后链接不断
• 重点标注框：关键结论用 callout 块单独高亮
• 图片嵌入：用![[图片]]语法插图并可指定显示宽度

搭建任务管理 base

• 按标签筛选：把带 task 标签的笔记收进同一个视图
• 公式算倒计时：根据截止日期自动生成“剩余天数”列
• 表格底部汇总：对数字列显示平均值等统计
• 一个文件双视图：活跃与已完成清单在同一个 .base 里分开展示

画一张项目思维导图

• 节点自动布局：节点之间留 50-100 像素间距，不互相压盖
• 连线表达关系：用带箭头的边指明方向，可加文字标签
• ID 唯一性检查：保存前核对所有 ID 不重复、边指向的节点都存在
• 分组着色：不同分组用不同颜色区分，层级一眼看清

🛠️ 避坑与答疑

问：装完之后需要改配置文件吗？不需要。OpenCode 会自动发现技能目录下的 SKILL.md，克隆完成后重启一次程序即可。

问：agent 写笔记正常，但调用 Obsidian CLI 没反应？CLI 技能要求本机正在运行 Obsidian，命令默认指向最近聚焦的仓库，多仓库用户需要在参数里指定仓库名。

问：obsidian-skills 只能配合 OpenCode 用吗？不是。它遵循 Agent Skills 开放规范，Claude Code、Codex 等支持该规范的 agent 同样能加载。

📚 资源与维护

• 官方文档：README.md
• Bases 公式参考：FUNCTIONS_REFERENCE.md
• Markdown 标注框参考：CALLOUTS.md
• 画布示例集：EXAMPLES.md

保持最新版只需进入克隆目录执行git pull，更新后重启 OpenCode：

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

装好之后，agent 产出的笔记、数据库和画布都符合 Obsidian 规范，你只管打开软件验收结果。先让它做一个小的阅读清单 .base，你会立刻感受到差别。

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