Obsidian Skills 实测报告：哪些能用，哪些是坑

前言：全网吹捧的工具，真的好用吗？

最近全网都在推荐 Obsidian Skills，说它能让 AI 完美操作 Obsidian 笔记，简直是"第二大脑"的神器。

但实际体验如何？我花了一上午时间实测，结果让人大跌眼镜。

这篇文章不跪舔、不吹捧，只讲实测结果：

• ✅ 哪些功能真的能用
• ❌ 哪些功能只是看起来美好
• 🤔 是否值得你花时间折腾

如果你正在考虑使用 Obsidian Skills，这篇文章能帮你避坑，节省时间。

---

什么是 Obsidian？

[!info] Obsidian 简介
Obsidian 是一款基于本地 Markdown 文件的知识管理工具，被誉为"你的第二大脑"。

核心特点

• 双向链接：通过 [[笔记名称]] 建立笔记之间的关联
• 图谱视图：可视化展示知识网络
• 插件生态：丰富的社区插件扩展功能
• 数据安全：所有数据存储在本地，完全掌控

[!warning] 格式兼容性问题
Obsidian 有一个独特的语法体系（维基链接、Callout、Frontmatter 等），这让普通 AI 工具很难生成符合格式的内容。

---

Obsidian Skills：AI 与笔记系统的完美结合

核心价值

Obsidian Skills 是 Obsidian 团队开发的一组开源工具，专门帮助 AI 工具（如 [[Claude Code]]）理解和生成符合 Obsidian 格式的内容。

三大核心技能

[!tip] obsidian-markdown
让 AI 生成符合 Obsidian 格式的增强型 Markdown

支持的语法：

• 维基链接：[[笔记标题]]
• 嵌入内容：![[图片.png]]
• Callout 块：> [!note] 提示框
• Frontmatter 属性：YAML 格式的元数据

[!warning] obsidian-bases ⚠️ 实测不可用
专注于 Obsidian 的数据库功能支持

核心功能（理论上）：

• 过滤器和排序
• 公式计算
• 数据汇总
• 视图管理

实测结果：经过多次测试，该 skill 只显示加载成功，但无法生成任何实质性输出。建议使用 obsidian-markdown skill 或 Dataview 插件替代。

[!tip] json-canvas
让 AI 直接编写 Obsidian Canvas 文件

应用场景：

• 思维导图
• 流程图
• 知识图谱

---

安装 Obsidian Skills：两种方式

前置条件

[!important] 安装要求

1. 已安装 [[Claude Code]]（Claude 官方命令行工具）
2. 已安装 [[Obsidian]] 并创建了笔记库

[!info] 仓库地址
Obsidian Skills 官方仓库：
https://github.com/kepano/obsidian-skills

这是 Obsidian 团队维护的开源项目，包含三个核心 skill：

• obsidian-markdown
• obsidian-bases
• json-canvas

方式一：市场安装（推荐）

第一步：打开 Claude Code

在终端中启动 Claude Code：

# Windows PowerShell
claude

# macOS/Linux
claude

第二步：添加插件市场

在 Claude Code 对话框中输入：

/plugin marketplace add kepano/obsidian-skills

第三步：安装插件

/plugin install obsidian@obsidian-skills

[!success] 安装成功
安装成功后，你会看到类似提示：

✓ 已成功安装 obsidian-markdown skill
✓ 已成功安装 obsidian-bases skill
✓ 已成功安装 json-canvas skill

方式二：手动安装

适用场景：如果市场安装失败，可以尝试手动安装。

步骤：

1. 克隆或下载 Obsidian Skills 仓库：

   git clone https://github.com/kepano/obsidian-skills.git
   

2. 将仓库内容复制到 Obsidian vault 根目录的 .claude 文件夹：

   你的Obsidian笔记库/
   └── .claude/
       └── obsidian-skills/
           ├── obsidian-markdown/
           ├── obsidian-bases/
           └── json-canvas/
   

3. 重启 Claude Code，技能会自动加载。

[!tip] 官方文档
更多安装细节请参考：
https://docs.anthropic.com/claude-code

[!warning] 实测警告
虽然显示"安装成功"，但根据实测，obsidian-bases skill 实际无法正常使用。安装后只有 obsidian-markdown 和 json-canvas 真正可用。

---

实战体验：让 AI 帮你整理笔记

场景一：批量生成读书笔记

你的需求：
“使用obsidian skill 帮我为《原则》这本书创建一套笔记结构，包括核心观点、金句摘录和个人思考”

AI 的输出（自动符合 Obsidian 格式）：

---
title: 原则 - 读书笔记
author: 瑞·达利欧
tags:
  - 读书笔记
  - 管理
  - 决策
created: 2026-01-12
---

# 原则 - 读书笔记

## 核心观点

> [!important] 核心理念
> 原则是应对现实的基本准则，帮助你在相似情境下做出更好的决策。

### 1. 极度求真
- [[极度求真的五个层次]]
- [[如何建立反馈循环]]

### 2. 极度透明
- [[透明文化的建立]]
- [[可信度加权决策]]

## 金句摘录

> [!quote]
> "痛苦 + 反思 = 进步"

相关笔记：[[成长型思维]]

## 个人思考

![[原则思维导图.canvas]]

场景二：创建知识图谱

你的需求：
“JSON Canvas skill 帮我创建一个关于 AI 技术栈的 Canvas 思维导图”

AI 会自动生成 .canvas 文件：

• 结构化的 JSON Canvas 文件
• 包含节点、连线、分组
• 可直接在 Obsidian 中打开编辑

[!example] Canvas 示例
生成的 Canvas 文件会包含：

• 文本节点：核心概念说明
• 文件节点：链接到相关笔记
• 链接节点：外部资源引用
• 分组节点：逻辑分类

场景三：数据库管理 ⚠️ 待确定（验证不通）

[!danger] 实测警告：obsidian-bases skill 无法正常使用
经过多次实际测试验证，obsidian-bases skill 存在严重问题：

• ✅ 显示：Successfully loaded skill （加载成功）
• ❌ 实际：没有任何实质性输出，无法生成 .base 文件
• ❌ 结果：只是表象成功，实际功能完全不可用
• ❌ 验证状态：本人实测验证不通过，功能无法使用

测试环境：

• Claude Code 最新版本
• Windows 11 + PowerShell
• 多次重复测试，结果一致

疑问：全网博主都在推荐 obsidian-bases skill，但实测根本无法使用。可能是个人环境问题，也可能是该 skill 本身存在 bug。如果你成功使用过，欢迎指正！

替代方案：建议直接使用 obsidian-markdown skill 手动创建 .base 文件，或使用 Obsidian 的 Dataview 插件。

你的需求（理论场景）：
“使用obsidian-bases skill 帮我创建一个项目管理数据库，包含任务名称、优先级、截止日期和状态”

理论上 AI 应该自动创建 .base 文件（但实测无法实现）：

---
filters:
  and:
    - file.hasTag("project")
    - 'status != "archived"'

formulas:
  days_until_due: 'if(due, ((date(due) - today()) / 86400000).round(0), "")'
  is_overdue: 'if(due, date(due) < today() && status != "done", false)'

properties:
  status:
    displayName: 状态
  formula.days_until_due:
    displayName: "剩余天数"

views:
  - type: table
    name: "进行中的任务"
    filters:
      and:
        - 'status == "in-progress"'
    order:
      - file.name
      - priority
      - due
      - formula.days_until_due
---

永远都是Successfully loaded skill，我已经调用了 obsidian-bases skill 来为你创建项目管理数据库，就没下文了。我要的不是一个.base的文件，我此时此刻就是在测试验证obsidian-bases skill能否成功创建一个数据库.base文件，事实证明，他永远只会Successfully loaded skill，他是真的在后台运行创建吗，还是就死掉了

---

效果对比：有无 Obsidian Skills 的差异

对比维度	普通 AI	使用 Obsidian Skills
链接格式	[笔记](笔记.md) ❌	[[笔记]] ✅
Callout 支持	不支持 ❌	> [!note] ✅
Frontmatter	格式错误 ❌	YAML 格式正确 ✅
Canvas 生成	无法生成 ❌	直接生成 JSON ✅
数据库操作	不理解 ❌	⚠️ 理论支持，实测不可用
批量重构	手动修改 ❌	自动化处理 ✅

---

适用场景：谁应该使用 Obsidian Skills？

个人知识管理者

[!check] 适用场景

• 快速构建知识体系
• 自动整理读书笔记
• 生成学习路线图

内容创作者

[!check] 适用场景

• AI 辅助写作，格式自动规范
• 批量生成文章大纲
• 管理创作素材库

项目管理者

[!check] 适用场景

• 创建项目数据库
• 可视化项目进度
• 自动生成会议纪要

研究人员

[!check] 适用场景

• 文献笔记整理
• 知识图谱构建
• 研究思路可视化

---

进阶技巧：让 AI 更懂你的笔记

1. 自定义 Prompt

在 Claude Code 中添加项目级配置文件 CLAUDE.md：

# 我的 Obsidian 笔记规范

## 笔记命名规则
- 使用中文标题
- 日期格式：YYYY-MM-DD
- 标签体系：#领域/子领域

## 常用模板
- 读书笔记：包含核心观点、金句、思考
- 项目笔记：包含目标、进度、问题
- 会议纪要：包含时间、参与者、决策事项

2. 批量重构笔记库

帮我检查笔记库中所有的外部链接，将 Markdown 格式转换为维基链接格式

3. 自动生成索引

帮我为 "AI 学习" 文件夹生成一个 MOC（Map of Content）索引页面

---

注意事项与最佳实践

⚠️ 使用前必读

[!warning] 重要提醒

1. 备份笔记库：在让 AI 批量操作前，务必备份你的 Obsidian 笔记库
2. 逐步验证：先在测试笔记上尝试，确认效果后再批量应用
3. 版本控制：建议使用 Git 管理笔记库，方便回滚

✅ 最佳实践

[!tip] 使用建议

1. 明确指令：告诉 AI 你的笔记规范和格式要求
2. 分步执行：复杂任务拆解为多个小步骤
3. 人工审核：AI 生成的内容需要人工审核和调整
4. 持续优化：根据使用体验不断优化 Prompt

---

总结：理想很丰满，现实很骨感

经过一上午的实测，Obsidian Skills 的真实情况是：

✅ 真正能用的

[!success] obsidian-markdown skill

• 实测可用：能生成符合 Obsidian 格式的 Markdown
• 核心价值：维基链接、Callout、Frontmatter 格式正确
• 推荐指数：⭐⭐⭐⭐⭐（强烈推荐）

[!success] json-canvas skill

• 实测可用：能生成 Canvas 文件
• 核心价值：自动化创建思维导图和知识图谱
• 推荐指数：⭐⭐⭐⭐（值得尝试）

❌ 看起来美好，实际不能用的

[!danger] obsidian-bases skill

• 实测结果：只显示加载成功，无任何实质输出
• 浪费时间：花了一上午调试，完全无法使用
• 推荐指数：⭐（不推荐，浪费时间）

🤔 我的建议

如果你是 Obsidian 用户：

• ✅ 可以尝试 obsidian-markdown skill，确实能提升效率
• ✅ json-canvas skill 也值得一试
• ❌ obsidian-bases skill 暂时别碰，等官方修复

如果你时间有限：

• 不如直接用 Claude Code 的原生工具 + 手动调整格式
• Dataview 插件可能比 obsidian-bases 更靠谱

总体评价：Obsidian Skills 不是神器，只是一个半成品工具。有用的部分确实有用，但别指望它能"彻底改变"你的笔记体验。

---

相关资源

Obsidian Skills 项目地址：
https://github.com/kepano/obsidian-skills

Claude Code 官方文档：
https://docs.anthropic.com/claude-code

Obsidian 官网：
https://obsidian.md

AI-Bot 教程：
https://ai-bot.cn/obsidian-skills/

---

结语

技术工具的价值在于实用，而不是概念包装。

Obsidian Skills 有它的价值，但远没有全网吹的那么神。obsidian-markdown 确实好用，json-canvas 也不错，但 obsidian-bases 就是个坑。

写这篇文章的目的：

• 帮你节省时间，避免像我一样浪费一上午
• 提醒你保持独立思考，不要盲目跟风
• 分享真实体验，而不是复制粘贴官方文档

如果你有不同的使用体验，欢迎交流。也许是我的环境问题，也许是工具本身的 bug，但至少我的实测结果是这样的。
欢迎关注公粽号FishTech Notes，一块交流使用心得！