AI Skills Plugin

Obsidian Skills

让 AI 代理掌握 Obsidian 文件操作的技能集。支持 Claude Code 和 Codex CLI,轻松创建和编辑 Markdown、Bases 和 Canvas 文件。

3 核心技能
MIT 开源协议
v1.0 版本
Obsidian + AI

项目概述

Obsidian Skills 遵循 Agent Skills 规范,可被任何兼容的 AI 代理使用

📝

Markdown 技能

创建和编辑 Obsidian 风格的 Markdown 文件,支持 wikilinks、embeds、callouts 等特性

📊

Bases 技能

创建和编辑 .base 文件,实现数据库视图、过滤器、公式和汇总功能

🎨

Canvas 技能

创建和编辑 JSON Canvas 文件,支持节点、边、分组的无限画布

核心特性详解

深入了解每个技能的功能和使用场景

📝 Obsidian Flavored Markdown

创建和编辑 Obsidian 风格的 Markdown 文件,支持所有 Obsidian 特有的语法扩展。

支持的语法特性

  • Wikilinks 内部链接:[[Note Name]] 和 [[Note Name|Display Text]]
  • Embeds 嵌入:![[Note Name]] 嵌入笔记、图片、PDF等
  • Callouts 标注:> [!note] 等多种类型的提示框
  • Properties 属性:YAML frontmatter 元数据
  • Tags 标签:#tag 和 #nested/tag
  • LaTeX 数学公式:$inline$ 和 $$block$$
  • Mermaid 图表:流程图、时序图等

📊 Obsidian Bases

创建和编辑 .base 文件,实现类似数据库的笔记视图功能。

核心功能

  • 多种视图类型:表格、卡片、列表、地图
  • 强大的过滤器:AND/OR/NOT 逻辑组合
  • 公式计算:日期运算、字符串处理、数学计算
  • 汇总统计:平均值、求和、最大/最小值等
  • 属性配置:自定义显示名称和格式
  • 分组排序:按属性分组和排序结果

🎨 JSON Canvas

创建和编辑 .canvas 文件,实现无限画布的可视化笔记。

节点类型

  • Text 文本节点:支持 Markdown 内容
  • File 文件节点:引用图片、PDF、笔记等
  • Link 链接节点:嵌入外部 URL
  • Group 分组节点:组织和容纳其他节点

连接功能

  • 边(Edges)连接任意两个节点
  • 支持标签和颜色自定义
  • 可设置连接方向和端点样式

安装指南

选择适合你的安装方式

通过 Marketplace 安装

最简单的安装方式,使用插件市场命令:

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

手动安装到 Claude Code

将仓库内容添加到 Obsidian vault 根目录的 /.claude 文件夹:

Shell
# 克隆仓库
git clone https://github.com/kepano/obsidian-skills

# 复制到你的 Obsidian vault
cp -r obsidian-skills/.claude-plugin /path/to/vault/.claude

安装到 Codex CLI

将 skills/ 目录复制到 Codex 技能路径:

Shell
# 克隆仓库
git clone https://github.com/kepano/obsidian-skills

# 复制到 Codex 技能目录
cp -r obsidian-skills/skills/* ~/.codex/skills/