obsidian-skills 完全上手指南：5 个技能让 AI 代理写出规范的 Obsidian 笔记与画布

obsidian-skills 完全上手指南5 个技能让 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 写 Obsidian 笔记它多半会丢给你一堆标准 Markdown——没有维基链接、没有 frontmatter、更没有能直接打开的.base或.canvas文件。obsidian-skills 就是为了解决这件事它是一套用 Agent Skills 规范打包的技能集覆盖 Obsidian 的五个领域Markdown 风味语法、Bases 数据库、JSON Canvas 画布、Obsidian CLI、网页正文提取 defuddle装好之后代理在碰到.md、.base、.canvas或帮我搜库这类请求时会自动按 Obsidian 的方言产出能直接渲染的结果。它适合已经在用 Obsidian、同时又在跑 Claude Code、Codex 或 OpenCode 的人。想象一个具体场景你刚读完一篇长文想让代理把正文洗干净、存成带属性的笔记、再挂进一个待读数据库、最后在画布上画一条到相关笔记的连线。手动做要开四个面板来回切装上这套技能后这四步可以串成一句话交给代理完成。先装进代理三种入口任选其一安装的目的只有一个——让代理的技能扫描器找到仓库里的SKILL.md。按你用的代理选一条即可全程不超过两行命令。Marketplace最快在支持插件市场的环境里加市场再装。/plugin marketplace add kepano/obsidian-skills /plugin install obsidianobsidian-skillsnpx skills适合命令行习惯的人https与ssh两种写法都支持。npx skills add https://github.com/kepano/obsidian-skills手动放置Claude Code 把仓库内容放进保险库根目录的.claude文件夹Codex 把skills/拷进~/.codex/skillsOpenCode 要克隆整仓只拷内层skills/会导致路径错位git clone https://gitcode.com/GitHub_Trending/ob/obsidian-skills.git ~/.opencode/skills/obsidian-skillsOpenCode 会按~/.opencode/skills/技能名/SKILL.md自动发现重启代理后无需再改任何配置。装完你应看到新开会话里让代理描述你会哪些 Obsidian 相关技能它能列出上面五个并各自给出用途或手动检查到对应目录下出现了SKILL.md。拿到第一个成果让代理产出第一篇规范笔记别急着背语法先逼代理跑通一次完整输出。直接下指令新建一篇笔记标题为项目复盘带 tags 和状态属性正文用维基链接指向我已有的两篇笔记并加一个警示标注框。代理会调用 skills/obsidian-markdown/SKILL.md 里的工作流先写 frontmatter再写正文再补维基链接、嵌入和标注框最后在 Obsidian 阅读视图里自检。你应看到文件顶部是合法的---frontmatter含tags/status正文里[[某笔记]]能点开跳转 [!warning]渲染成带图标的框在 Obsidian 阅读视图下没有任何报错或裸符号。这一步跑通说明技能已被正确加载。核心用法拆解一把 Obsidian 的 Markdown 方言写对标准 Markdown 代理都会这套技能的价值在方言。四个高频点维基链接 vs 普通链接库内笔记用[[Note]]、[[Note#Heading]]、[[Note|显示文本]]Obsidian 能跟踪重命名外部网址才用text。标注框 [!note]、 [!warning]、 [!faq]-折叠等note、tip、warning、info、example、todo等常用类型一览见 references/CALLOUTS.md。frontmattertags、aliases、cssclasses等默认属性与全部类型见 references/PROPERTIES.md。嵌入给维基链接前加!就能内联如![[image.png|300]]、![[doc.pdf#page3]]音频、视频、搜索嵌入见 references/EMBEDS.md。验证方式把代理产出的笔记切到阅读视图链接可跳、标注框有样式、嵌入的图片和 PDF 页正常渲染再改一下被链接笔记的文件名发现链接仍指向原笔记这是维基链接而非普通链接的标志。核心用法拆解二建 Bases 库和 JSON Canvas 画布这两个是非 Markdown能力代理若没装技能基本写不对。Bases.baseYAML定义范围过滤器、公式、视图。最小可用片段filters: and: - file.hasTag(task) - file.ext md views: - type: table name: Active Tasks filters: and: - status ! done order: [file.name, status, due]过滤器支持and/or/not嵌套视图支持table、cards、list、map四种公式里日期相减得到的是 Duration 类型取.days后才能再算。完整函数表在 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.mdYAML 引号规则与常见报错的排查都在 skills/obsidian-bases/SKILL.md 里。JSON Canvas.canvasJSON顶层就是{nodes: [], edges: []}节点类型有text/file/link/group每个节点要 16 位十六进制id加x/y/width/height连线用fromNode/toNode指回已存在的节点。最小可渲染画布{ nodes: [ { id: 8a9b0c1d2e3f4a5b, type: text, x: 0, y: 0, width: 300, height: 150, text: # 中心概念\n\n正文。 } ], edges: [] }布局经验节点间隔留 50–100px、组内留 20–50px 内边距文本节点宽 300–450 / 高 150–300 比较舒服。更多可直接抄的结构思维导图、项目看板、研究画布、流程图见 skills/json-canvas/references/EXAMPLES.md。验证方式.base在 Obsidian 里打开即渲染成视图、不弹 YAML 报错.canvas打开后节点位置不重叠、连线指向正确节点且 JSON 能被解析。场景一个人把一篇网页研究收进你的库你想解决的读到的文章要手动复制、去广告、再整理成带属性的笔记还要挂进数据库和画布四步来回切面板。能力怎么组合让代理用 defuddle 抓正文——defuddle parse url --md会剥掉导航和广告只留正文要存文件加-o content.md要单独取标题/描述用-p title、-p description详见 skills/defuddle/SKILL.md。用 obsidian-markdown 给这篇清洗后的内容补 frontmatter、加维基链接指回你已有的相关笔记。用 obsidian-bases 建一个研究资料库按file.hasTag(research)过滤加个reading_time公式估时长。用 json-canvas 把这篇笔记和一个外链节点连成一条边标注来源。四步串一句把这篇文章抓下来、存成研究笔记、放进 research 库并在画布上连到我之前那篇综述。 完成后你会看到库里多一行该笔记、画布上多一条带标签的连线、笔记正文是干净的 Markdown。场景二团队统一模板 任务看板你想解决的成员笔记格式各异、任务散落各处没有一个统一的进度视图。能力怎么组合用 obsidian-markdown 的 frontmatter 约定统一字段status、priority、due、tags让所有人的笔记长得一致。用 obsidian-cli 批量补属性obsidian property:set namestatus valuedone file某笔记或一次建一批带模板的笔记obsidian create name... content... template... silent命令参考 skills/obsidian-cli/SKILL.md。用一个.base做看板groupBy按status分组、table视图显示file.name / status / due再配一个is_overdue公式高亮超期项。需要可视化分工时把几个人的负责模块做成 json-canvas 的group节点。你应看到一个.base文件同时是进行中/已完成两列看板新笔记只要打上task标签就会自动出现超期的行被公式标红。场景三进阶用 CLI 把日常维护自动化你想解决的每天固定动作追加待办、建每日笔记、搜历史靠手动点容易漏。能力怎么组合前提Obsidian 处于打开状态追加今日待办obsidian daily:append content- [ ] 新任务只读不弹窗地建笔记obsidian create name每日复盘 silent查库内内容obsidian search query关键词 limit10批量看标签分布obsidian tags sortcount counts指定保险库把vault库名作为第一个参数配合 defuddle 抓料、obsidian-bases 出视图就能搭一条抓取 → 归档 → 汇总的无人值守流程。CLI 还带一套插件/主题开发命令plugin:reload、dev:errors、dev:screenshot、eval适合在写 Obsidian 插件时用它跑改代码—重载—查错—截图的循环。你应看到终端里命令依次返回笔记内容、任务列表或标签计数加--copy还能把结果送进剪贴板加silent则不弹开文件。进阶要点与常见坑性能.base里用limit截断结果、把重计算放进formulas而不是重复写视图大型库会明显更顺画布节点别堆太密保持间距。校验习惯Bases 改完检查引号含特殊字符的字符串要加引号公式里嵌套双引号时外层用单引号Canvas 改完确认id唯一、fromNode/toNode都指向存在的节点、JSON 可解析。类型坑Bases 里两日期相减是 Duration必须先取.days再round()属性可能缺失用if()兜底再参与计算。链接选择库内用维基链接可跟踪重命名外部用普通链接别混用。自测清单过一遍能全勾上就说明这套技能真正用起来了代理在新会话里能列出全部五个技能并说清用途代理产出的.md在 Obsidian 阅读视图无报错维基链接可跳、重命名后仍有效能独立写出带and/or/not过滤和至少一个公式的.base且打开即渲染能生成一个含text节点与一条有效edges连线的.canvas打开不报 JSON 错用defuddle parse url --md拿到过一份干净正文用obsidian daily:append和obsidian search各跑通一次能讲清Duration 要先取.days库内用维基链接两条避坑规则一条主线上手路线主心骨是代理产出可被 Obsidian 直接渲染的三类文件先让代理装好技能并产出第一篇规范笔记跑通闭环再依次吃透 Markdown 方言、Bases 库、Canvas 画布最后用 CLI 和 defuddle 把重复动作自动化、把外部资料收进库。几个要点装对入口手动放置时别漏了SKILL.md的层级、每步都验证渲染阅读视图不报错才算过、先小后大先用最短片段跑通再加复杂过滤/连线。按这条线走下来你会从让 AI 帮我写笔记进阶到让 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），仅供参考