Obsidian Skills 是一套用于 Obsidian 的 Agent Skills 技能平台，当前版本 1.0.0。它遵循通用 Agent Skills 规范，可被 Claude Code、Codex、OpenCode 等客户端使用，让智能体直接创建与编辑 Obsidian 笔记文件。
一、项目简介
Obsidian Skills 由作者 kepano 维护，把 Obsidian 的 Markdown 扩展语法、Bases 数据库、画布文件与命令行能力封装成技能。仓库地址 https://github.com/kepano/obsidian-skills 。
二、项目功能
1. Obsidian Markdown 技能
创建与编辑 Obsidian 风格的 Markdown，支持双向链接、嵌入、标注与属性等专属语法。
2. Bases 与画布技能
创建与编辑 Bases 数据库文件与 JSON Canvas 画布，支持视图、过滤器与节点连接。
3. 命令行与网页提取技能
通过 Obsidian CLI 操作仓库，并可用 Defuddle 从网页提取干净 Markdown，减少上下文消耗。
4. 模板渲染技能
用 Knap 从 JSON 或 CSV 数据渲染 Markdown 模板，支持批量生成文件。
三、项目亮点
该技能集让智能体真正理解 Obsidian 的专属格式，写笔记、建数据库、画画布都能自动完成，是 Obsidian 用户的效率利器。
对比手动编辑
对比该技能集和手动编辑笔记的区别，差异在自动化程度。技能让智能体按规范生成文件，手动编辑依赖经验与记忆。
| 对比项 | Obsidian Skills | 手动编辑 |
|---|---|---|
| 编辑方式 | 智能体自动 | 手工操作 |
| 语法正确性 | 按规范生成 | 易出错 |
| 批量化 | 支持模板 | 逐条处理 |
四、项目结构
项目以 skills 目录组织，每个技能为自包含文件夹并含 SKILL.md，遵循标准 Agent Skills 目录结构便于各客户端自动发现。
五、技术栈
- 技能格式遵循 Agent Skills 规范
- 面向 Obsidian 笔记与画布格式
- 兼容 Claude Code、Codex、OpenCode
- 未附带 MIT 或 Apache 许可证声明，作者信息以仓库主页为准
项目由作者 kepano 维护，最后更新 2026 年，版本持续迭代，更新日志见 GitHub 提交历史。仓库地址 https://github.com/kepano/obsidian-skills 。
六、本地快速部署启动
方式一 插件市场安装
在 Claude Code 中执行 /plugin marketplace add kepano/obsidian-skills 与 /plugin install obsidian@obsidian-skills 完成安装。
方式二 npx 安装
执行 npx skills add https://github.com/kepano/obsidian-skills 安装技能。
方式三 手动安装
把仓库内容放入 Obsidian 仓库根目录的 .claude 文件夹，或把 skills 目录复制到对应客户端的技能路径。
适用场景与建议
适用场景方面，它适合重度使用 Obsidian 做知识管理与写作的用户，让智能体批量生成与整理笔记；也适合研究人员把网页内容提取成干净 Markdown 归档。建议先在测试仓库验证生成效果，再用于正式笔记库，重要内容做好备份，避免自动化误改造成损失。
国内加速与备份
国内访问较慢时可用 ghfast.top 等镜像加速前缀，更详细的部署说明可扫码获取本站备份。备份包版本 v1.0.0，文件校验 sha256 5b644fa459e6a227088250b628c076d776cebbfb64b1c7c00302c094d9c8a26e 。
七、项目代码地址
项目代码地址 https://github.com/kepano/obsidian-skills 。
常见问题
问. Obsidian Skills 是做什么的
它是一套用于 Obsidian 的 Agent Skills 技能集，让智能体创建与编辑笔记文件。
问. 怎么快速上手使用
用插件市场或 npx 安装技能，或把 skills 目录放入客户端技能路径。
问. 和手动编辑有什么区别
对比手动编辑，技能让智能体按规范自动生成笔记与画布，支持批量处理。
问. 是否开源免费
项目在 GitHub 公开，未附带 MIT 或 Apache 许可证声明，可免费使用。
