obsidian-skills
为 Obsidian 设计的 Agent Skills 集合,遵循标准 Agent Skills 规范,可直接用于 Claude Code、Codex、OpenCode 等兼容 agent。覆盖官方 Obsidian Flavored Markdown、Bases、JSON Canvas、CLI 交互,以及 Defuddle 网页转 Markdown,让 agent 能原生读写 Obsidian 生态格式。值得关注的是它由 Obsidian CEO kepano 维护,安装方式灵活(marketplace、npx、手动),且 skill 格式标准化,能显著提升 agent 处理个人知识库的能力。
README
用于 Obsidian 的 Agent Skills。
这些技能遵循 Agent Skills 规范,因此可以被任何兼容该规范的 agent(智能体)使用,包括 Claude Code、Codex 和 Open Code。
安装
Marketplace
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills
npx skills
npx skills add git@github.com:kepano/obsidian-skills.git
如果你更喜欢使用 https 而不是 ssh:
npx skills add https://github.com/kepano/obsidian-skills
手动安装
Claude Code
将本仓库的内容添加到你的 Obsidian vault(笔记库)根目录下的 /.claude 文件夹中(或你使用 Claude Code 的任何文件夹)。更多信息请参阅 官方 Claude Skills 文档。
Codex
将 skills/ 目录复制到你的 Codex skills 路径(通常是 ~/.codex/skills)。有关标准技能格式,请参阅 Agent Skills 规范。
OpenCode
将整个仓库克隆到 OpenCode 的 skills 目录(~/.opencode/skills/):
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills
不要只复制内部的 skills/ 文件夹——请克隆完整仓库,使目录结构为 ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md。
OpenCode 会自动发现 ~/.opencode/skills/ 下所有 SKILL.md 文件。无需修改 opencode.json 或任何配置文件。重启 OpenCode 后技能即可用。
技能
| 技能 | 描述 |
|---|---|
| obsidian-markdown | 创建和编辑 Obsidian Flavored Markdown (.md) 文件,支持 wikilinks(维基链接)、embeds(嵌入)、callouts(提示框)、properties(属性)及其他 Obsidian 专属语法 |
| obsidian-bases | 创建和编辑 Obsidian Bases (.base) 文件,支持视图、筛选器、公式和摘要 |
| json-canvas | 创建和编辑 JSON Canvas 文件 (.canvas),支持节点(nodes)、边(edges)、分组(groups)和连接(connections) |
| obsidian-cli | 通过 Obsidian CLI 与 Obsidian vaults 交互,包括插件和主题开发 |
| defuddle | 使用 Defuddle 从网页中提取干净的 markdown,去除杂乱内容以节省 tokens |