📋 核心要点
  • 官方仓库 kepano/obsidian-skills（MIT，46.5k stars）为 Obsidian 提供 Agent Skills，让 Claude Code / Codex / OpenCode 等智能体直接操作 vault
  • 遵循 Agent Skills 规范，可被任何 skills-compatible 的 agent 使用
  • 含 5 个技能：obsidian-markdown、obsidian-bases、json-canvas、obsidian-cli、defuddle
  • 安装方式三种：Marketplace 插件、npx skills 命令、手动复制到各 agent 的 skills 目录
  • 注意事项：OpenCode 需克隆整个仓库而非仅 inner 目录；Claude Code 需放 .claude/ 目录

相关：Claudian：把 AI 编程代理嵌入 Obsidian 的插件

仓库概况

  • 仓库：github.com/kepano/obsidian-skills（作者 kepano，Obsidian 官方 CEO）
  • 定位：Agent Skills for Obsidian —— 教会你的 agent 使用 Obsidian CLI 和开放格式（Markdown、Bases、JSON Canvas）
  • 协议：MIT License
  • 数据：46.5k stars、3.3k forks、242 watching、46 commits

功能清单（5 个技能）

技能用途
obsidian-markdown创建/编辑 Obsidian 风格 Markdown：wikilinks、嵌入、callout、properties 等 Obsidian 专属语法
obsidian-bases创建/编辑 Obsidian Bases（.base）：视图、过滤、公式、汇总
json-canvas创建/编辑 JSON Canvas（.canvas）：节点、边、分组、连接
obsidian-cli通过 Obsidian CLI 与 vault 交互，含插件与主题开发
defuddle从网页提取干净的 Markdown，去除杂乱以节省 token

注：其中 obsidian-markdown、obsidian-bases、json-canvas、obsidian-cli、defuddle 与本库已启用的技能对应。

安装方式

方式一：Marketplace 插件

Bash
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

方式二：npx skills

Bash
npx skills add git@github.com:kepano/obsidian-skills.git

若不用 ssh、偏好 https：

Bash
npx skills add https://github.com/kepano/obsidian-skills

方式三：手动安装（按 agent 分别说明）

Claude Code

把仓库内容加到 Obsidian vault 根目录（或你使用 Claude Code 的目录）下的 .claude/ 文件夹里。详见官方 Claude Skills 文档。

Codex

把 skills/ 目录复制到 Codex 的 skills 路径（通常是 ~/.codex/skills）。

OpenCode

把整个仓库克隆到 OpenCode 的 skills 目录：

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

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

注意事项

  1. OpenCode 必须克隆整个仓库，不能只复制 inner 的 skills/ 目录 —— 目录结构须为 ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md。
  2. Claude Code 放 .claude/ 目录，而非任意位置；注意是 vault 根目录（或工作目录）下的 .claude。
  3. Codex 只需复制 skills/ 内层目录到 ~/.codex/skills，与 OpenCode 相反，别混。
  4. 遵循 Agent Skills 规范：这些技能能被任何兼容 Agent Skills 的 agent 使用（Claude Code、Codex、Open Code 等），不是 Obsidian 专属。
  5. 使用 obsidian-cli 技能需 Obsidian 正在运行（CLI 依赖本地 Obsidian 实例）。
  6. 仓库仅有 skills/、.claude-plugin/、LICENSE、README.md，不含构建/依赖，安装即用。

来源