obsidian-skills 完整指南：五个技能包教会 AI 操作 Obsidian-育师

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-skills

AI 写笔记，卡住你的从来不是"写什么"，而是"怎么写才不崩"——它随手吐出的 Markdown，在 Obsidian 里经常渲染不出来：双链打不开、callout 退化成纯文本、frontmatter 少个字段就全废。obsidian-skills 冲的就是这个断层：一个开源的 Agent Skills 技能包，把 Obsidian 的写法、Bases 视图、Canvas 画布和 obsidian-cli 命令，打包成 AI 能直接调用的能力。装一次，Claude Code、Codex、Open Code 这些代理都能加载。

按"先认识、再装、再上手、最后踩坑"走一遍就够。

这套技能包含哪五块：先认识 obsidian-skills

打开skills/目录，是五个平级文件夹，各带一份SKILL.md说明书，互不依赖，用哪个算哪个：

技能	管什么	落在什么文件上
obsidian-markdown	双链、嵌入、callout、frontmatter、公式、Mermaid	`.md`
obsidian-bases	数据库视图、过滤器、公式、汇总	`.base`
json-canvas	节点、连线、分组、布局	`.canvas`
obsidian-cli	命令行增删改查、插件调试	整个 vault
defuddle	网页正文提取，省 token	任意网页

最容易被忽略的是 obsidian-markdown。它不产文件，只给 AI 立规矩：库内笔记一律[[Note]]而不是Note，这样你改文件名时 Obsidian 能跟着自动更新；强调用> [!important]，元数据进 frontmatter。一句话，它把"会写 Markdown"的 AI 变成"会写 Obsidian 认得的 Markdown"。

10 分钟装好 obsidian-skills

先分清：技能是喂给 AI 的"规则"，不自己跑东西；真正读写 vault 的是 obsidian-cli、defuddle 这些命令。所以装两层——技能进 AI，命令进终端。

最省事走插件市场，两条命令搞定；不吃插件市场的工具，用 npx 拉一份：

# 插件市场 /plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills # npx npx skills add https://gitcode.com/GitHub_Trending/ob/obsidian-skills

走手动就三选一：Claude Code 把仓库内容放进 vault 根目录的.claude/；Codex 把skills/拷到~/.codex/skills；OpenCode 克隆整仓git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills，注意是整仓，别只拷内层skills/。放完重启工具，技能自动被发现，任何配置文件都不用动。

obsidian-cli 常用命令

周一开完会，你说一句"把这份纪要存进库，标题叫 Q3 排期会"，它就调 obsidian-cli 生成合规笔记，callout、待办、双链一起带上。前提是 Obsidian 开着——CLI 连的是正在运行的实例。记不全没关系，先跑obsidian help：

obsidian create name="Q3 排期会" content="# 纪要\n\n> [!important]\n> 结论：提前两周定选题" obsidian search query="竞品分析" limit=20 obsidian property:set name="状态" value="已归档" file="Q3 排期会" obsidian daily:append content="- [ ] 周五交初稿"

file=用名字定位，像双链一样不写路径和扩展名；path=才给 vault 根目录的完整路径。列表类命令加total出个数，加--copy直接进剪贴板。

Bases 公式避坑

Bases 相当于给笔记库装了个查询窗口：一个.base就是段 YAML，filters圈哪些笔记进来，formulas算派生字段，views定表格还是卡片。AI 建好之后，你改一条 frontmatter，表里那格立刻跟着变。

filters: 'file.hasTag("选题")' formulas: 预计成本: 'if(预算, 预算 * 0.8, "")' views: - type: table name: "本月选题" order: [file.name, 负责人, formula.预计成本]

报错九成集中在这三条：公式含双引号就用单引号把整条包住，写成'if(done, "是", "否")'；两个日期相减得到的是 Duration 不是数字，先取.days再.round()；属性可能为空时套一层if()，别让它直接炸。

手写 .canvas 画布

Canvas 是一份公开规范的 JSON，核心就nodes和edges两个数组。AI 生成一个.canvas，你打开就是原生画布，能拖能连，团队讨论直接发生在库里。

{ "nodes": [ { "id": "6f0ad84f44ce9c17", "type": "text", "x": 0, "y": 0, "width": 300, "height": 140, "text": "# 短视频" }, { "id": "1a2b3c4d5e6f7a8b", "type": "text", "x": 420, "y": 0, "width": 300, "height": 140, "text": "## 长图文" } ], "edges": [ { "id": "3c4d5e6f7a8b9c0d", "fromNode": "6f0ad84f44ce9c17", "toNode": "1a2b3c4d5e6f7a8b", "label": "对比" } ] }

节点能是文本、文件、外链，还能用group当分组容器包一层；颜色、连线方向、锚点都有约定。两个必查点：节点id是 16 位十六进制串，别撞车；每条edge的fromNode/toNode必须指向已存在的节点，指空了整张画布就废。

defuddle 抓网页正文

存网页最怕把侧栏、弹窗、推广位一并拖进库里，越攒越乱、越吃 token。defuddle 把整版"报纸"剪成一篇正文，直接吐 Markdown：

defuddle parse https://example.com/report --md defuddle parse https://example.com/report --md -o 行业报告.md defuddle parse https://example.com/report -p title

--md出 Markdown，不加默认是 HTML；-o指定落盘文件名；-p单抽标题、描述这类元信息。对资讯页、博客、文档站这类页面，它比通用爬虫省 token，排版也更规整。