obsidian-skills 实战：5 个 Agent 技能让 AI 正确读写和检索 Obsidian 笔记

obsidian-skills 实战：5 个 Agent 技能让 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

让 Agent 整理笔记，它把 wikilink 写成普通 Markdown 链接，往 canvas 文件里塞进字面量的 \n。obsidian-skills 是一套 Agent 技能，教 Claude Code、Codex、OpenCode 等遵循 Agent Skills 规范的 AI 代理掌握 Obsidian 特有语法与库操作，让它能正确地读写和检索笔记。

📚 五个技能对应五类文件：先搞清楚各管什么

obsidian-skills 解决的问题一句话就能说清：AI 代理擅长写文本，但不了解 Obsidian 的方言。5 个技能各管一类文件或操作面，可单独使用，也可组合。每个技能由一份 SKILL.md 和可选的 references/ 子目录组成，代理先读文档再动手，比如 obsidian-markdown 附带了 callout、embed、属性字段的完整语法参考。

• defuddle：从网页提取正文并输出干净的 Markdown，去掉导航和冗余内容以节省 token。适合需要把网页资料、长文批量入库的分析师。
• obsidian-cli：通过终端命令操作正在运行的 Obsidian 实例，可创建笔记、搜索、设置属性和管理每日笔记。适合想把库操作脚本化、接入现有工具链的人。
• obsidian-markdown：在标准 Markdown 之上补齐 Obsidian 扩展语法，包括 wikilink、嵌入、callout、frontmatter 属性。适合需要让代理批量产出规范笔记模板的团队。
• obsidian-bases：用 .base 文件把笔记库变成数据库视图，支持过滤器、公式和表格或卡片视图。适合用笔记管理项目、书单、任务的人。
• json-canvas：按 JSON Canvas 规范读写 .canvas 文件，覆盖节点、连线与校验规则。适合让代理直接产出思维导图和流程图。

⚙️ 三个实操场景：从入库素材、进度表格到终端检索

下面三个场景都可以直接跑：一个处理外部资料入库，一个把笔记库变成表格视图，一个在终端里完成创建与检索。

用 defuddle 把网页文章提取成干净 Markdown

外部长文入库时，原始 HTML 会把上下文塞满还浪费 token，defuddle 就是入库前的第一步，用法见 skills/defuddle/。

# 用途：把文章正文提取为 Markdown 并保存，顺便取标题和摘要 defuddle parse https://docs.example.com/guide/intro --md -o intro.md defuddle parse https://docs.example.com/guide/intro -p title defuddle parse https://docs.example.com/guide/intro -p description

执行后得到一份去掉导航与广告噪声的文件，可以直接放进 vault，代理后续读取它的 token 开销明显更低。

用 Bases 的 .base 文件搭一张任务进度表

任务笔记攒了几个月，每周都要手动翻一遍 status 看谁逾期。用 .base 文件把这一步变成表格视图，完整语法在 skills/obsidian-bases/。

# 用途：把带 task 标签的未完成笔记渲染成表格，自动算出距到期天数 filters: and: - file.hasTag("task") - 'status != "done"' formulas: days_until_due: 'if(due, (date(due) - today()).days, "")' views: - type: table name: "Active Tasks" order: - file.name - status - due - formula.days_until_due

把文件存成 tasks.base 后在 Obsidian 里打开，所有未完成的任务笔记会汇总成一张表，到期天数列每天自动更新，不用再翻笔记。

用 Obsidian CLI 创建笔记并检索整个 vault

表格是看给眼睛的，日常操作还得从终端读写库。obsidian CLI 要求 Obsidian 处于运行状态，常用命令收录在 skills/obsidian-cli/。

# 用途：创建一条会议纪要，检索相关决议，再把这条笔记标记完成 obsidian create name="会议纪要 2026-08-30" content="# 决议\n\n- 笔记库迁入 Git 版本管理" silent obsidian search query="决议" limit=20 obsidian property:set name="status" value="done" file="会议纪要 2026-08-30"

三条命令依次完成创建、检索、标记，搜索结果直接回到终端，可以继续管道给后续脚本。

📌 装好之后先做的三件事

选一个支持 Agent Skills 规范的代理安装。obsidian-skills 的 README 给出 marketplace、npx skills、手动复制三种方式，分别对应 Claude Code、Codex 与 OpenCode。以 OpenCode 为例，要克隆整个仓库，而不是只复制 skills/ 子目录：

# 用途：把 obsidian-skills 装进 OpenCode 的技能目录（必须整库克隆） git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills ~/.opencode/skills/obsidian-skills

克隆完成后重启 OpenCode 即可自动发现全部技能，不需要改任何配置文件。

先统一属性约定，再搭视图。先约定好一组 frontmatter 字段（status、due、tags），再让代理按模板写新笔记，这样每个 .base 里的过滤器才能跨库、跨人复用。

把 vault 放进 Git 做版本控制。五个技能的所有产物（.md、.base、.canvas）都是纯文本，代理写入的改动天然可以按提交记录和合并请求做 diff 与评审，写错了能回滚。

把语法细节交给技能，代理只需要对内容本身负责。完整安装方式与技能清单见 README.md。

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