Appearance
obsidian-skills：给 Obsidian 装上 AI 大脑。5 个技能让 AI 编程助手学会操作 Obsidian，30K+ Stars，MIT 开源。
项目概览
| 指标 | 数据 |
|---|---|
| GitHub Stars | 30K+ |
| AI 技能数 | 5 个 |
| 开源协议 | MIT |
这是给谁用的
适合人群：
- 使用 Obsidian 管理笔记的人
- 同时使用 Claude Code、Codex CLI 或 OpenCode 等 AI 编程助手的人
- 需要 AI 帮你整理知识库的人
解决的问题：AI 编程助手默认不懂 Obsidian 的特殊语法。你跟它说"建一个带双向链接的笔记"，它可能输出普通 Markdown 而不是 Obsidian 能识别的 [[Wikilink]]。
5大技能详解
1. obsidian-markdown
作用：掌握 Obsidian Flavored Markdown 全部语法
| 语法 | 说明 |
|---|---|
[[Wikilink]] | 双向链接 |
![[嵌入]] | 嵌入内容 |
> [!note] | Callout 标注 |
--- | 属性（Properties） |
2. obsidian-bases
作用：操作 Obsidian 的数据库功能
| 功能 | 说明 |
|---|---|
| 创建 .base 文件 | 数据库视图 |
| 编辑视图 | 筛选、分组 |
| 编辑筛选器 | 条件筛选 |
| 编辑公式 | 数据计算 |
3. json-canvas
作用：创建和编辑 .canvas 文件
| 功能 | 说明 |
|---|---|
| 创建节点 | 文本/卡片/媒体 |
| 编辑节点 | 内容、样式 |
| 操作连线 | 连接关系 |
| 分组管理 | 组织结构 |
4. obsidian-cli
作用：通过 Obsidian CLI 与知识库交互
| 功能 | 说明 |
|---|---|
| 插件开发 | 创建 Obsidian 插件 |
| 主题开发 | 自定义主题 |
| 命令行操作 | 批量处理 |
5. defuddle
作用：从任意网页提取干净 Markdown
| 功能 | 说明 |
|---|---|
| 提取正文 | 去除广告、导航 |
| 格式转换 | 转为 Obsidian 格式 |
| 直接存储 | 存入 Obsidian 知识库 |
典型使用场景
场景一：AI 帮你整理知识库
需求：把这篇网页整理成笔记，加上相关话题的双向链接
操作：
让 Claude Code 执行：
1. 用 defuddle 提取网页内容
2. 整理成 Obsidian 格式
3. 添加相关笔记的链接
4. 保存到知识库场景二：AI 帮你创建知识图谱
需求：用 Canvas 画布创建知识图谱
操作：
让 Claude Code 执行：
1. 创建 canvas 文件
2. 添加相关笔记节点
3. 用连线表示关系
4. 分组整理场景三：AI 帮你管理数据库
需求：创建一个阅读笔记数据库
操作：
让 Claude Code 执行：
1. 创建 .base 数据库文件
2. 定义字段：书名、作者、阅读日期、评分
3. 添加阅读笔记
4. 创建筛选视图安装与使用
安装步骤
bash
# 1. 克隆仓库
git clone https://github.com/obsidian-ai/skills.git
# 2. 进入目录
cd obsidian-skills
# 3. 查看技能列表
ls skills/在 Claude Code 中使用
bash
# 1. 将技能添加到 Claude Code
cp -r skills/obsidian-markdown ~/.claude/skills/
# 2. 重启 Claude Code
# 3. 开始使用
/obsidian "帮我创建一个读书笔记模板"技能结构
每个技能的结构：
skill-name/
├── SKILL.md # 核心定义文件
├── scripts/ # 辅助脚本
│ ├── setup.py
│ ├── validate.py
│ └── ...
└── references/ # 参考文档SKILL.md 结构
markdown
---
name: skill-name
description: 技能描述
---
# 技能名称
## 功能
- 功能1
- 功能2
## 使用方法
如何调用
## 示例
代码示例五大技能速查表
| 技能 | 核心功能 | 适用场景 |
|---|---|---|
| obsidian-markdown | 双链、Callout、属性 | 笔记整理 |
| obsidian-bases | 数据库、筛选、公式 | 数据管理 |
| json-canvas | 画布、节点、连线 | 知识图谱 |
| obsidian-cli | 插件开发、命令行 | 开发者 |
| defuddle | 网页提取、格式转换 | 内容采集 |
与 Claude Code 配合
示例：创建双向链接笔记
你：帮我把这篇文章整理成 Obsidian 笔记
Claude Code：
1. 读取文章内容
2. 用 [[Wikilink]] 添加相关笔记链接
3. 添加 > [!note] Callout 标注重点
4. 保存为 .md 文件示例：创建知识图谱
你：帮我创建一个"AI 工具"的知识图谱
Claude Code：
1. 创建 AI-tools.canvas
2. 添加节点：Claude、GPT、Codex
3. 用连线表示关系
4. 导出为图片常见问题
Q：需要安装 Obsidian 插件吗？
A： 不需要。这是给 AI 看的说明书，不是 Obsidian 插件。
Q：支持中文吗？
A： 支持。Obsidian 本身就支持中文。
Q：可以自定义技能吗？
A： 可以。参考 SKILL.md 格式创建自己的技能。
Q：和其他 AI 工具配合吗？
A： 支持 Claude Code、Codex CLI、OpenCode 等。
一句话总结
obsidian-skills = 给 AI 编程助手看的 Obsidian 使用手册。
5大技能：Markdown 双链、数据库、Canvas 画布、CLI 命令、网页提取。
核心价值：让 AI 真正读懂你的知识库，而不是输出普通 Markdown。
