Obsidian Skills
Obsidian CEO 官方出品的 Agent Skill 插件包：零脚本纯文档型 skill，教 Agent 写出 Obsidian 能正确解析的 Markdown/Bases/Canvas 文件，并用 Obsidian CLI 操作真实 vault、Defuddle 提取网页正文，把笔记库变成 Agent 的数据库与画布。
仓库：kepano/obsidian-skills
热度证据：45.2k star，Obsidian CEO 出品
五维评分
热度5/5
质量5/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- 官方作者亲写规范：plugin.json 署名 Steph Ango（Obsidian CEO），格式文档即产品第一手规范，45.2k star 的权威性与零错误风险是二手教程无法复制的
- description 内嵌触发词与反触发词：如 defuddle 明确 'Do NOT use for URLs ending in .md'，把 skill 路由变成确定性决策规则，降低选错率
- WRONG/CORRECT 对照教学：bases 的 YAML 引号、Duration 类型先 .days 再 round、未定义 formula 'fail silently' 等坑全部用对错代码块沉淀，agent 不会产出渲染错误的文件
- 显式验证清单：json-canvas 给出 8 条 Validation Checklist（ID 唯一、edge 引用、类型枚举、JSON 可解析），把写后自检固化为必做步骤
- 完整可跑示例 + 四端分发：每 skill 结尾有完整示例（Project Alpha 笔记/Task Tracker base/mind map canvas），README 覆盖 marketplace/npx/Claude Code/Codex/OpenCode 安装
可复用的设计模式
- 官方格式规范重写为 agent 工作流（步骤+速查+示例+校验），不写脚本纯文档即可成 skill
- 验证清单（Validation Checklist）作为写后强制自检点
- WRONG/CORRECT 反模式对照教学，特别标注静默失败类错误
- SKILL.md 主路径 + references/ 全量参考的懒加载分层文档
- marketplace.json 将多个互补 skill 打包成插件一次安装
适用场景
Agent 批量生成/整理 Obsidian 笔记（日记、任务追踪、读书清单、frontmatter 属性规范）用 obsidian-cli 对运行中的 vault 做读写搜索、属性管理、daily 笔记追加生成 .canvas 可视化思维导图/流程图、.base 数据库视图（任务看板、阅读列表）Obsidian 插件/主题开发调试闭环（reload → dev:errors → screenshot → console）抓取网页正文转 Markdown 进笔记库（Defuddle，替代 WebFetch 省 token）
边界与注意：纯文档型 skill 零脚本，全部能力依赖外部前置：obsidian-cli 要求本机已打开 Obsidian 并装好 CLI，defuddle 需 npm install -g；bases 依赖 Obsidian 较新版本（1.9+），旧版用户装上也用不了；不负责笔记库的语义组织设计，且对非 Obsidian 用户价值有限。
完整拆解分析文档
本页为摘要版，完整精读分析（核心机制、逐条优秀点拆解、写作过程）见本地 Markdown 文档：
analysis/obsidian-skills.md