Obsidian 必装 Skills 与核心插件

发表于 更新于 分类于 阅读次数： 本文字数： 2k 阅读时长 ≈ 7 分钟

Skills 总览

作者 Skill 功能简述 推荐
Obsidian CEO @kepano defuddle 网页内容清洗 → 纯净 Markdown，节省 Token ✅
obsidian-cli AI 调用 Obsidian 官方 CLI，增删改查笔记/任务/属性 ✅
obsidian-bases 创建 .base 动态数据库视图（类 Notion） ✅
obsidian-markdown 编写符合 Obsidian 规范的增强 Markdown ⚠️
json-canvas 创建/编辑 .canvas 白板文件 ❌
Axton @回到Axton obsidian-canvas-creator 加强版 Canvas，解决节点重叠与空间分布问题 ✅
mermaid-visualizer 文本 → Mermaid 图表，内置 Obsidian 语法纠错 ✅
excalidraw-diagram 文本 → 手绘风格 Excalidraw 图表 ✅
OpenClaw 官方 obsidian-skill 直接文件 I/O，已被官方 CLI 取代 ❌
Choi Wontak tutor-skills 文档/代码 → 结构化知识库 + 互动式测验闭环 ✅
EESJGong scholar-skill 分级阅读论文 → 双链卡片 + MOC + 知识冲突报告 ✅
ℹ️GitHub 仓库索引
  • kepano/obsidian-skills
  • axtonliu/axton-obsidian-visual-skills
  • RoundTable02/tutor-skills
  • EESJGong/scholar-skill
  • openclaw/openclaw/skills/obsidian

@kepano（Obsidian CEO）

defuddle

📌网页内容清洗工具，自动剔除广告和导航栏，输出纯净 Markdown，大幅减少 Token 消耗。

依赖

  • Node.js 运行环境
  • 全局安装：npm install -g defuddle

触发方式 — 发送 URL 并要求阅读/分析/总结时自动触发

1
提取这个网页的正文，转成干净的 Markdown 格式：[URL]。
⚠️局限性
对标准 HTML 网页（新闻、博客、文档）效果最佳；需登录或纯动态渲染的单页应用可能抓取失败。最近更新已支持 YouTube 视频字幕提取（调用官方 API）。

obsidian-cli

📌让 AI Agent 通过 Obsidian 官方 CLI 直接操作笔记、任务、属性与插件开发环境。

配置步骤

  1. Obsidian 客户端版本 ≥ 1.12
  2. 设置 → 常规 → 打开”命令行界面 (CLI)”
  3. 确认注册到系统 Path
  4. 保持 Obsidian 运行状态

验证配置

1
obsidian daily

若配置正确，Obsidian 会自动应用日记模板并生成当日日记。

obsidian-bases

📌通过 YAML 格式 .base 文件创建类 Notion 数据库视图，支持公式系统（条件判断、日期运算、字符串处理）。

依赖

  • Maps 插件（仅地图视图需要）

支持视图类型：table / cards / list / map

1
2
写一个 .base 文件来管理我的项目笔记，要求筛选出所有带 #project 标签的文件，
用表格显示项目名称、截止日期和剩余天数。

obsidian-markdown

📌让 AI 编写符合 Obsidian 规范的增强 Markdown（双向链接、嵌入、Callouts、Frontmatter 属性）。
1
2
根据这段会议记录生成一份 Obsidian 笔记。要求在顶部包含日期和参会人的属性，
使用双向链接关联到"项目 A"笔记，并把关键决策点用 important 类型的提示框标注。
💡进阶用法
可将个人 Obsidian 格式偏好注入 Skill 配置，确保 Agent 生成的笔记始终符合你的风格规范。

json-canvas

📌创建/编辑 .canvas 白板文件，通过 JSON 结构定义节点与连线逻辑。
1
2
创建一个名为"AI 学习路径"的 json canvas 文件。
中心是一个文本节点，连向三个文件节点：模型基础、提示词工程、智能体实战。
📌不推荐
功能较基础，建议优先使用 obsidian-canvas-creator 替代。

@回到Axton（Axton）

obsidian-canvas-creator

📌加强版 Canvas Skill，内置径向布局（MindMap）和自由排版（Freeform）算法，自动计算坐标与间距。
1
把这 markdown 知识笔记转换成一个 mindmap 格式的 Obsidian Canvas。

与 json-canvas 的对比

维度 json-canvas obsidian-canvas-creator
侧重点 底层 JSON 语法正确性 高层排版策略与空间坐标计算
自动化 机械摆放节点 自动计算 X/Y 坐标，确保不重叠
布局模式 无特定模式 MindMap / FreeForm 模式，自动处理父子层级

mermaid-visualizer

📌文本逻辑 → 专业 Mermaid 图表，内置 Obsidian 渲染引擎语法纠错。
1
2
根据这段关于软件开发生命周期的描述生成一个横向的 Mermaid 流程图，
要求包含不同的子图来区分开发环境和测试环境。

excalidraw-diagram

[summary] 文本逻辑 → 手绘风格 Excalidraw 图表，支持动画步骤。

依赖

  • Excalidraw 插件（必须安装并启用）
1
2
用 Excalidraw 画一个 AI 智能体的工作流动画图，
按照感知、思考、行动的顺序设置动画步骤，并保存为 .excalidraw 文件。

@Choi Wontak（RoundTable02）

tutor-skills

📌由 tutor-setup + tutor 构成”输入 → 内化 → 检测”闭环：一键将文档/代码库转化为结构化知识库，再通过互动式测验暴露知识盲区。

依赖

  • 智能体工具（Claude Code / OpenCode 等）

使用方法

  • /tutor-setup — 构建学习金库（StudyVault）
  • /tutor — 触发互动式测验

特殊机制 — 模式自动侦测

检测到的文件 自动进入模式
package.json / pom.xml 等工程文件 代码库模式（递归读取 + 架构溯源）
仅 PDF / 纯文本 文档模式
⚠️Token 消耗风险
代码库模式会递归读取大量源文件并执行 Phase C1–C9 架构溯源循环，短时间内消耗大量 Token。

@EESJGong

scholar-skill

[summary] 学术研究 Skill，通过 L1/L2/L3 分级阅读策略，将论文转化为 Obsidian 双链卡片、MOC 与知识冲突报告。

依赖环境

类型 内容
基础环境 本地 Python + Obsidian 客户端
核心框架 OpenClaw 智能体框架
必须依赖 obsidian-direct、arxiv-watcher、durable-task-runner
可选增强 tavily（联网）、pdf（文本解析）、academic-research-hub

触发条件 — 匹配”阅读论文”、”L1/L2/L3 阅读”、”知识内化”、”文献笔记”时自动触发

1
2
3
获取这篇文献 ArXiv:2407.19354 并进行处理。
先做 L1 快速评估，如果判定为 P0 优先级，则请在后台直接启动 L3 深度阅读。
完成后将知识树更新推送到我的 Obsidian 对应目录。

核心机制

  • 超长周期任务编排 — L3 深度阅读设计为 ~2.5 小时异步挂机任务，依赖 durable-task-runner 处理多次 LLM 推演循环、API 限流与崩溃恢复
  • 周期性反思 — 内置时间触发器，周末/月末自动对临时知识进行 L2/L3 反思，生成演进报告
  • 人类确认防呆 — AI 发现新论文推翻旧笔记结论时，不直接覆写，而是生成确认单放入 0-Inbox 等待人工审核
⛔风险预警
  • 财务风险：L3 循环 + 高频 RAG 检索消耗大量 Token，挂载商用前沿模型（Claude 3.5 Sonnet / GPT-4o）时单篇深读账单可能很高
  • 数据风险：底层 obsidian-direct 使用 Python 暴力文件 I/O（非官方 CLI），多端同步期间易引发文件冲突/内容丢失。强烈建议在独立测试库运行并开启 Git 快照

核心插件

claudian

ℹ️Obsidian 第三方插件（暂未上架官方市场），适配 Claude Code。
GitHub: YishenTu/claudian

安装方式

方案 A：通过 BRAT 安装（推荐）

  1. 安装 BRAT（在 Obsidian 插件市场搜索）
  2. 设置 → BRAT → Add Beta plugin → 输入 YishenTu/claudian
  3. 在第三方插件列表中开启 Claudian

方案 B：手动加载

  1. 从 GitHub Releases 下载 main.js、manifest.json、styles.css
  2. 在 .obsidian/plugins/ 下新建 claudian 文件夹，放入三个文件
  3. 重启 Obsidian → 手动启用

插件设置

  1. 设置 User Name（如 Jason）
  2. 自定义 AI 模型（兼容 Anthropic 接口，如智谱 GLM 或 DeepSeek）：
1
2
3
ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
ANTHROPIC_API_KEY=你的智谱api key
ANTHROPIC_DEFAULT_OPUS_MODEL=GLM-5
  1. 验证：Ctrl/Cmd + P → 输入 claudian → Open chat view → 发送”你好”

obsidian-agent-client

ℹ️第三方插件（暂未上架官方市场），适配主流智能体：Claude Code / Codex / Gemini CLI / OpenCode / Qwen Code。
GitHub: RAIT-09/obsidian-agent-client

配置步骤（以 OpenCode 为例）

  1. 打开 agent-client 设置页 → Custom Agent → Add Custom Agent
  2. 设置 Agent ID 和 Display Name 为 OpenCode
  3. 命令行输入 where opencode 获取安装路径，填入 Path
  4. Arguments 配置：
1
2
3
acp
--cwd
D:\Obsidian Vault\MyObVault
  1. 验证：在 Agent Client 对话框中发送”你好”，确认回复正常