Obsidian Skills とは・使い方｜kepano製Agent SkillsでObsidianをAIエージェント化

Obsidian Skills は、Obsidian CEOのkepano氏が公開した5つのAgent Skillsで、Markdown・Bases・JSON Canvas・Obsidian CLIの「作法」をAIエージェントに教えるパッケージだ。Claude Code に特化して解説するため、Claude Code 全般は Claude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き をご覧ください。

Obsidian Skillsとは — AIエージェントにObsidianの「作法」を教える5つのスキル

Obsidianのナレッジベースをエージェントに操作させるときの障壁は、Wikilinks・callouts・.base・JSON Canvasといった標準Markdownにない独自の記法だ。これをエージェントに正確に教えるのがObsidian Skillsである。

kepano/obsidian-skills は 43,655スター・3,113フォーク（2026年7月30日時点）、MITライセンス（LICENSEファイルあり）。直近のプッシュは2026-06-08で、skills/ 配下の5つは本記事公開時から変わっていない。

Claude Skillsの仕組みを徹底解説した記事で紹介したとおり、Agent Skillsは「フォルダにSKILL.mdを置くだけ」で作れる。Obsidian Skillsも各スキルをskills/スキル名/SKILL.mdに置き、リポジトリ直下に.claude-plugin/を持つ。

開発元のCEOが自ら書いた理由は単純で、エージェントが[[]]や> [!type]を知らなければリンクが壊れ、calloutの書式が崩れるからだ。記法の一次情報を持つ側が書くことで、公式仕様と食い違わない。

Obsidian Skillsのインストール方法 — Marketplace・npx・手動の3パターン

Marketplace（推奨）

Marketplace対応のツールでは2行で終わる。

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

Microsoft APMのようなパッケージマネージャーと組み合わせるなら、apm.ymlにkepano/obsidian-skillsを書いてapm installすれば、チーム全員に同じスキルを配れる。

npx skills

Node.jsがあれば、Gitリポジトリから直接入れられる。

npx skills add [email protected]:kepano/obsidian-skills.git

手動（エージェント別）

Claude CodeはVaultルートの.claude/を自動スキャンし、SKILL.mdを見つけるとスキルとして登録する（Claude Codeのベストプラクティス完全ガイドで解説した検出の仕組み）。

# Claude Code: Vaultルートに配置して起動
cd ~/Documents/MyVault
mkdir -p .claude
git clone https://github.com/kepano/obsidian-skills.git .claude/obsidian-skills
claude

# Codex CLI: skills/ の中身をコピー
git clone https://github.com/kepano/obsidian-skills.git /tmp/obsidian-skills
cp -r /tmp/obsidian-skills/skills/* ~/.codex/skills/

# OpenCode: リポジトリ全体をそのまま置く（skills/だけをコピーしない）
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

OpenCodeは起動時に~/.opencode/skills/以下のSKILL.mdをすべて検出するので、設定ファイルの編集は要らない。

5つのスキルの中身 — 記法・Bases・Canvas・CLI・Web抽出

エージェントはタスクに応じて必要なスキルだけを読み込むので、5つ全部が常にコンテキストを消費するわけではない。

obsidian-markdown — Obsidian Flavored Markdown

Wikilinks・embeds・callouts・Properties（YAMLフロントマター）を教える基盤スキル。手順は「プロパティを書く → 本文を書く → Wikilinksでつなぐ → embedで埋め込む → calloutで強調」の5ステップ。

[[Note Name|表示テキスト]]   [[Note Name#見出し名]]   [[Note Name#^block-id]]
![[Another Note]]   ![[image.png]]   ![[document.pdf#page=5]]

> [!warning] 注意
> 警告メッセージ

このスキルが無いと、エージェントは[[]]の代わりに[]()形式のリンクを書き、グラフビューやバックリンクが働かなくなる。

obsidian-bases — データベースビュー

.baseファイル（YAML）で、ノートのメタデータを表のように扱う。ビューはtable・cards・list・mapの4種類（mapはlatitude・longitudeとMapsプラグインが必要）。

filter:
  - and:
    - "file.hasTag('task')"
    - "status != 'done'"
formulas:
  days_remaining: "if(deadline, (deadline - today()).days, 'No deadline')"
views:
  - type: table
    name: "タスク一覧"
    order:
      - property: priority
        direction: desc

json-canvas — ビジュアルキャンバス

JSON Canvas Spec 1.0に準拠し、ノード（text・file・link・group の4種）とエッジで組む。ノードIDは16文字の16進数で一意、エッジのfromNode/toNodeは既存のIDを指す。こうした検証ルールもスキルが教える。座標はピクセル単位で、X軸は右、Y軸は下に増える。

obsidian-cli — コマンドラインからVaultを操作

起動中のObsidianに対して、ノートの読み書き・検索・プロパティ・タスクを操作する。値は=で渡し、スペースを含む値はクォートで囲む。

obsidian read file="Daily Note"
obsidian create path="Projects/NewProject.md" content="## 概要\nプロジェクトの説明"
obsidian search query="meeting agenda"
obsidian property set file="MyNote" key="status" value="in-progress"
obsidian reload-plugins   # プラグイン開発: リロード

プラグイン・テーマ開発では、リロード・obsidian evalでのJavaScript実行・モバイル表示の切り替えまでCLIで回せる。

defuddle — Webページから本文だけを抽出

ナビゲーション・広告・サイドバーを落として本文だけをマークダウンにし、トークンを節約する。

npm install -g defuddle
defuddle parse https://example.com/article --md -o content.md   # Markdownで保存
defuddle parse https://example.com/article -p title             # メタデータだけ

フラグ無しならJSONで出る。URLが.mdで終わるページには使わない（すでにMarkdownのものに通すと書式が崩れることがある）。

Agent Skills仕様との関係 — なぜ「SKILL.md＋フォルダ」なのか

Agent Skills仕様は、トークンを節約するために段階的開示（Progressive Disclosure）を採っている。

SKILL.mdのfrontmatterで決まっているフィールドは次のとおり。

最小のSKILL.mdは、nameとdescriptionの下に手順を書くだけだ。

---
name: my-custom-skill
description: カスタムスキルの説明。このスキルは○○のときに使う。
---

1. ステップ1
2. ステップ2

仕様はAnthropicが策定したオープン標準で、2026年4月時点で30以上のツールが対応している。

フォルダとMarkdownだけなのでGitでそのまま管理・共有でき、特定のベンダーに縛られない。

実践ワークフロー — Web取り込みとプロジェクト一覧

会議ノート：「今日の会議ノートを作成して」と頼むと、obsidian-markdownが読み込まれ、Wikilinks・embeds・callouts・タスクのチェックボックスを仕様どおりに書く。汎用のエージェントでは[Sprint Review](Sprint%20Review.md)のような形になり、バックリンクが効かない。

Web取り込み：defuddleで本文を抜き、obsidian-cliでVaultに保存してプロパティを付ける。

defuddle parse https://example.com/research-article --md -o /tmp/article.md
obsidian create path="Research/2026-04-17-article.md" content="$(cat /tmp/article.md)" silent
obsidian property set file="Research/2026-04-17-article" key="source" value="https://example.com/research-article"

プロジェクト一覧：obsidian-basesで、Projectsフォルダのノートを更新からの日数つきで並べる.baseを作れる。

# Projects.base
filter:
  - and:
    - "file.inFolder('Projects')"
    - "status != 'archived'"
formulas:
  days_since_update: "(today() - file.mtime).days"
  health_indicator: "if(days_since_update > 14, 'Stale', if(days_since_update > 7, 'Warning', 'Active'))"

構成図：json-canvasで、コードベースの構成をノードとエッジのキャンバスにできる。ノードが重ならないよう、widthに100px程度の間隔を足した値を次のノードのxにするのが基本形だ。

Obsidian Skillsの導入判断 — 入れる前と後の違い

CLAUDE.mdにObsidianの記法ルールを自分で書くこともできるが、Basesのフィルタ構文やCanvasのJSON仕様まで網羅するのは現実的ではない。開発元が書いた記法の正確さと、Agent Skills仕様による複数エージェント対応を両立している点が差になる。

Agent Skillsに初めて触れる人にとっては、「SKILL.mdをどう書けばいいか」の実装例としても読める。Claude Skillsの仕組みを解説した記事と合わせて読むと、設計思想から実装まで一続きで追える。

関連記事: Claude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き

参照ソース

• kepano/obsidian-skills - GitHub — Obsidian Skills公式リポジトリ（README、全SKILL.mdファイル）
• Agent Skills Specification — Agent Skills仕様の完全なフォーマット定義
• agentskills.io — Agent Skills公式サイト（対応ツール一覧、仕様概要）
• JSON Canvas Spec 1.0 — JSON Canvasのオープン仕様
• Obsidian CLI Documentation — Obsidian CLI公式ドキュメント