Obsidian Skills

项目地址： https://github.com/kepano/obsidian-skills

为 Obsidian 设计的 Claude Code 插件，提供 Obsidian 文件编辑技能。

核心概念

[!WARNING] 重要澄清 obsidian-skills 是 Claude Code 插件，不是 Obsidian 插件。

误区	正确理解
在 Obsidian 社区插件里找	==你不会在 Obsidian 的"社区插件"列表中看到它==
给 Obsidian 添加功能	它不改变 Obsidian 本身的功能
让 Claude Code 理解 Obsidian	==它让 Claude Code 能够读写 Obsidian 格式的文件==

实际作用

[!TIP] 一句话总结 加载 Obsidian 语法规则文档，让 Claude Code 有参考资料可查阅。

[!NOTE] Claude 本身已经能理解 Obsidian 格式

Claude 模型训练时已接触过大量 Obsidian 文档和 vault

Obsidian 语法本质是 Markdown 扩展，Claude 天生懂 Markdown

==插件是"锦上添花"，不是必须的==

插件提供的内容：

[!NOTE] 插件提供内容

语法参考文档（callout 类型别名、properties 类型等细节）

.canvas 和 .base 文件格式参考

obsidian-cli 命令参考（需单独安装 CLI）

安装方法（Claude Code）

方法 1：编辑 settings.json（推荐）

打开全局配置文件：%USERPROFILE%\.claude\settings.json
添加 marketplace 和插件启用配置：

{
  "extraKnownMarketplaces": {
    "obsidian-skills": {
      "source": {
        "source": "github",
        "repo": "kepano/obsidian-skills"
      }
    }
  },
  "enabledPlugins": {
    "obsidian@obsidian-skills": []
  }
}

重启 Claude Code
首次启动时会自动克隆插件，或手动克隆：

git clone https://github.com/kepano/obsidian-skills.git %USERPROFILE%\.claude\plugins\marketplaces\obsidian-skills

方法 2：使用 /plugin 命令

在 Claude Code 中输入：

/plugin add kepano/obsidian-skills

[!WARNING] 如果提示 Unknown skill: plugin 或 marketplace 未找到，请使用方法 1。

包含的 Skills

Skill	用途
obsidian-markdown	创建/编辑 Obsidian Flavored Markdown（维基链接、嵌入、callouts、属性等）
obsidian-bases	创建/编辑 Obsidian Bases（视图、过滤、公式、摘要）
json-canvas	创建/编辑 JSON Canvas 文件（节点、边、组、连接）
obsidian-cli	通过 Obsidian CLI 与 vault 交互（插件和主题开发）
defuddle	使用 Defuddle 清理网页内容为 Markdown，节省 token

验证安装

安装完成后，重启 Claude Code，输入：

/skills

应该能看到 obsidian-* 相关的技能。

注意事项

[!WARNING] 重要提示

这是插件，不是独立技能：obsidian-skills 是一个完整的 Claude Code 插件，需要通过插件系统加载

全局安装：安装一次后，所有项目都可以使用

==需要重启生效==：修改 settings.json 或安装插件后，必须重启 Claude Code

On this page