Obsidianのノートをもっと効率よく管理したい。でもAIアシスタントはObsidian独自のMarkdown記法やBasesの構文を知らない——この問題を、Obsidian CEOのSteph Ango氏自身が解決しました。

公式リポジトリ「obsidian-skills」は、AIコーディングエージェントにObsidian Vaultの読み書きと推論を教えるAgent Skillsパッケージです。GitHubスターは27,000超、MITライセンスで公開されています。

この記事でわかること

  • obsidian-skillsが解決する課題
  • 5つのスキルの役割と使い分け
  • Claude Code・Codex CLI・OpenCodeへの導入手順
  • Agent Skills仕様との関係

なぜAIはObsidianを正しく扱えなかったのか

https://github.com/kepano/obsidian-skills

ObsidianはCommonMarkを独自に拡張しています。[[ウィキリンク]]、![[埋め込み]]、> [!callout]、YAMLプロパティ、.baseファイル、.canvasファイルなど、標準Markdownにはない記法が多数あります。

AIエージェントにこれらの記法を知らせずにノートの作成や編集を任せると、リンクが壊れたり、Basesのフィルタ構文が不正になったりします。プロンプトに毎回書式ルールを貼り付ける方法もありますが、手間がかかり、更新に追従できません。

obsidian-skillsは、この問題をAgent Skills仕様に準拠したスキルファイル群で解決します。エージェントが必要なときだけスキルを読み込み、正しい記法でObsidianファイルを扱えるようになります。

5つのスキルの内容

リポジトリには5つのスキルが含まれています。それぞれが独立したフォルダにSKILL.mdファイルを持ち、エージェントはタスクに応じて必要なスキルだけを読み込みます。

obsidian-markdown

Obsidian Flavored Markdownの読み書きを担当します。ウィキリンク、埋め込み、コールアウト、プロパティ（フロントマター）、ブロックID、コメントなど、Obsidian固有の構文をすべてカバーしています。referenceフォルダにはPROPERTIES.md、EMBEDS.md、CALLOUTS.mdといった補足資料も含まれており、エージェントは詳細な仕様を参照できます。

obsidian-bases

Obsidian Bases（.baseファイル）の作成と編集を担当します。BasesはYAMLベースのデータベースビュー機能で、ノートの一覧をテーブル・カード・リスト・マップ形式で表示できます。フィルタ条件、数式、ソート順の書き方がスキル内に定義されています。

json-canvas

JSON Canvas（.canvasファイル）を扱います。JSON Canvasはノードとエッジで構成されるビジュアルボード形式で、Obsidianのキャンバス機能の基盤です。ノード、グループ、接続の作成方法がスキルに含まれています。

obsidian-cli

Obsidian CLI経由でVaultを操作します。ノートの作成・検索・プロパティ管理に加え、プラグインやテーマの開発に使うデバッグ機能（プラグインのリロード、JavaScript実行、スクリーンショット取得、DOM検査）もカバーしています。Obsidianが起動中である必要があります。

defuddle

WebページからクリーンなMarkdownを抽出するDefuddle CLIを使うスキルです。ナビゲーションや広告を除去し、トークン使用量を削減します。Obsidian固有の機能ではありませんが、Web情報をVaultに取り込む際に有用です。

導入方法

3つのインストール方法が用意されています。

マーケットプレイス経由

Claude Codeのプラグインマーケットプレイスから直接追加できます。

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

npxコマンド

npx経由でもインストールできます。

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

手動インストール

Claude Codeの場合は、Obsidian Vaultのルートに.claudeフォルダを作り、リポジトリの内容を配置します。Codex CLIは~/.codex/skillsディレクトリへコピー、OpenCodeは~/.opencode/skills/にリポジトリをクローンします。

OpenCodeの場合は内側のskills/フォルダだけでなく、リポジトリ全体をクローンする必要があります。

Agent Skills仕様との関係

obsidian-skillsはAgent Skills仕様（agentskills.io）に準拠しています。この仕様は、AIエージェントにドメイン知識を教えるためのオープンな標準フォーマットです。2026年5月時点で、Claude Code、Codex CLI、Gemini CLI、VS Code Copilot、Cursor、JetBrains Junieなど32以上のツールが採用しています。

仕様の設計原則は「プログレッシブ・ディスクロージャー」です。各スキルは要約時に数十トークンしか消費せず、タスクに必要なときだけ全文を読み込みます。obsidian-skillsもこの仕組みに従っているため、5つのスキルをすべて登録しても、使わないスキルがコンテキストを圧迫しません。

Agent Skills仕様に準拠しているため、Claude CodeやCodex CLIに限らず、仕様をサポートする任意のエージェントで動作します。特定のプラットフォームに依存しない点が、MCP（Model Context Protocol）ベースの連携とは異なる特徴です。

まとめ

obsidian-skillsは、Obsidianの開発元が自ら公開した公式スキルセットです。AIエージェントがObsidian固有の記法を正確に扱えるようになるため、ノートの作成・整理・検索を安心して委任できます。Agent Skills仕様に準拠しているため、今後対応エージェントが増えても同じスキルがそのまま使えます。