kepano/obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

What it solves

此專案提供一套專門的工具（技能），讓 AI 代理——如 Claude Code、Codex 與 Open Code——能與 Obsidian vault 互動。它彌合了大型語言模型代理與 Obsidian 特定資料格式之間的鴻溝，使它們能以符合 Obsidian 獨有語法與結構的方式建立與編輯內容。

How it works

本專案實作了 Agent Skills 規範，這是一種標準化的格式，用於定義 AI 代理可使用的工具。將這些技能安裝到代理的環境中後，代理即可使用針對不同 Obsidian 任務的專屬工具，包括管理帶有 wikilink 與 callout 的 Markdown 檔案、處理 JSON Canvas 檔案，以及與 Obsidian CLI 互動。

Who it’s for

此套件適用於使用 Obsidian 作為主要知識庫，且希望 AI 代理（如 Claude Code 或 Codex）能讀寫、編輯筆記與畫布的使用者。

Highlights

  • Obsidian-specific syntax support：支援 Obsidian Flavored Markdown，包括屬性與嵌入。
  • Canvas support：能建立與編輯 .canvas 檔案（JSON Canvas）。
  • Obsidian Bases support：能管理帶有篩選與公式的 .base 檔案。
  • CLI Integration：提供與 Obsidian CLI 互動的工具，協助插件與主題開發。
  • Web Content Extraction：內建工具可透過 Defuddle 從網頁提取乾淨的 Markdown，以減少 token 使用量。