给 Obsidian 装上 AI 大脑：obsidian-skills 完全指南

📝

5 个技能让 AI 编程助手学会操作 Obsidian，30K Stars 开源项目安装指南

原文链接：https://mp.weixin.qq.com/s/yNkJzNO-_PEnu49JdM9p9Q

5 个技能让 AI 编程助手学会操作 Obsidian，30K Stars 开源项目安装指南

#Obsidian #AI代理 #开源

长话短说

5 个技能让 AI 编程助手学会操作 Obsidian：从 Markdown 双链到 Canvas 画布，从数据库到 CLI。30K+ Stars，MIT 开源，一篇看懂。

30K+

GitHub Stars

AI 技能

MIT

开源协议

小白先看懂：这项目是干什么的

这是给谁用的 — 如果你在用 Obsidian 管理笔记，同时用 Claude Code、Codex CLI 或 OpenCode 这类 AI 编程助手写代码，这个项目就是为你准备的。

它解决的核心问题 — AI 编程助手默认不懂 Obsidian 的特殊语法。你跟它说“建一个带双向链接的笔记”，它可能输出普通 Markdown 而不是 Obsidian 能识别的 [[Wikilink]]。obsidian-skills 就是一本说明书，提前教会 AI 代理 Obsidian 的各种方言怎么读写。

不适合谁 — 如果你只是把 Obsidian 当普通笔记本用，不碰命令行、不写代码，这个项目对你没有意义。它不是传统 Obsidian 插件，不会在界面上多出任何按钮。它是给 AI 编程代理看的，不是给人看的。

五大技能详解

▸ obsidian-markdown — 掌握 Obsidian Flavored Markdown 全部语法，包括 Wikilinks、嵌入、Callouts、Properties 等扩展。

▸ obsidian-bases — 操作 Obsidian 的数据库功能，创建和编辑 .base 文件中的视图、筛选器和公式。

▸ json-canvas — 创建和编辑 .canvas 文件，操作节点、连线、分组。

▸ obsidian-cli — 通过 Obsidian CLI 与知识库交互，支持插件和主题开发。

▸ defuddle — 从任意网页提取干净 Markdown，去除广告和导航干扰，直接存入 Obsidian。

典型使用场景

场景一：AI 帮你整理知识库

你跟 AI 说“把这篇网页整理成笔记，加上相关话题的双向链接”。obsidian-markdown 让 AI 写出正确的 Wikilink，defuddle 帮它提取网页正文，json-canvas 让它可以生成知识图谱画布。

场景二：AI 管理你的数据库

用 Obsidian Bases 管理项目进度，让 AI 帮你添加记录、更新状态、按条件筛选——不需要手动打开每个文件。

场景三：AI 批量创建笔记

从 API 文档生成一批带正确格式的 Obsidian 笔记，每条包含 Properties 元数据和双向链接。obsidian-cli 自动将文件放入正确目录。

项目概况

kepano/obsidian-skills 由 Obsidian 核心团队成员（Minimal 主题作者）Kepano 创建，2026 年 1 月发布。4 个月拿下 30,000+ Stars、2000+ Forks，是 2026 上半年增长最快的 Obsidian 生态项目之一。

项目遵循 Agent Skills 规范，不绑定特定 AI 工具——Claude Code、Codex CLI、OpenCode、Clawdbot 等兼容规范的代理都能用。MIT 协议，开源免费。

阶段评估 项目处于早期快速增长阶段。Kepano 主导开发，5 位贡献者，39 次提交。社区活跃度极高，但尚未发布正式版本号。核心功能稳定，可投入日常使用。

安装方法

● OpenCode Marketplace（最简方式）

1 2	/plugin marketplace add kepano/obsidian-skills /plugin install obsidian@obsidian-skills

● npx skills

1 2	npx skills add git@github.com:kepano/obsidian-skills.git npx skills add https://github.com/kepano/obsidian-skills

● 手动安装（OpenCode）

1 2	cd ~/.opencode/skills git clone https://github.com/kepano/obsidian-skills.git

OpenCode 会自动发现 ~/.opencode/skills/ 下所有 SKILL.md，无需改配置文件，重启即生效。

前置条件

● 已安装至少一种 AI 编程代理（Claude Code / Codex CLI / OpenCode）

● 有一个正在使用的 Obsidian 知识库

● 有基本的命令行操作能力

几点提醒

FIX注意

确认兼容性 — 你的 AI 代理必须支持 Agent Skills 机制。Claude Code、Codex CLI、OpenCode、Clawdbot 都支持。

先在测试库使用 — 让 AI 直接操作知识库有一定风险，建议先用测试库熟悉。

CLI 需额外配置 — obsidian-cli 要求本机已安装 Obsidian CLI，不是装了就自动有效。

SOURCES

GitHub Repository — github.com/kepano/obsidian-skills

Agent Skills Spec — agentskills.io/specification

Obsidian Flavored Markdown — help.obsidian.md

💬 本文评论区已开启，但暂无读者留言。

本文转载自微信公众号，如有侵权请联系删除。