Obsidian Skills完全ガイド：Agent Skills仕様でObsidianとAIエージェントを接続する方法

この記事ではClaude Codeに特化して解説します。Claude Code全般は Claude Code完全ガイド2026：インストールから本番運用まで をご覧ください。

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

Obsidianで構築したナレッジベースをAIエージェントに操作させたいとき、最大の障壁は「Obsidian独自の記法」だ。Wikilinks、callouts、.baseファイル、JSON Canvas——標準的なMarkdownとは異なるこれらの仕様を、AIエージェントに正確に教えるのがObsidian Skillsである。

kepano/obsidian-skills は、Obsidian CEOのkepano（Stephan Ango）氏が自ら開発したAgent Skillsパッケージだ。GitHubで 24.5kスター、1.6kフォークを獲得し、MITライセンスで公開されている。

このパッケージには5つのスキルが含まれている。

Claude Skillsの仕組みを徹底解説した記事で紹介したように、Agent Skillsは「フォルダにSKILL.mdを置くだけ」で作れる。Obsidian Skillsもこの仕組みに完全準拠しており、各スキルはskills/スキル名/SKILL.mdという構造で整理されている。

obsidian-skills/
├── .claude-plugin/
├── skills/
│   ├── obsidian-markdown/
│   │   └── SKILL.md
│   ├── obsidian-bases/
│   │   └── SKILL.md
│   ├── json-canvas/
│   │   └── SKILL.md
│   ├── obsidian-cli/
│   │   └── SKILL.md
│   └── defuddle/
│       └── SKILL.md
├── LICENSE
└── README.md

なぜkepano氏が自ら開発したのか

Obsidianは標準的なMarkdownに独自の拡張（Wikilinks [[]]、embeds ![[]]、callouts > [!type]）を加えている。AIエージェントがこれらの仕様を知らなければ、リンクが壊れたり、calloutの書式が崩れたりする。Obsidianを最も深く理解している開発元のCEOが直接スキルを書くことで、公式仕様との完全な整合性が保証されている。

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

Obsidian Skillsは3つの方法でインストールできる。環境やツールに応じて選択する。

パターン1：Marketplace（推奨）

Agent Skills Marketplaceに対応したツールでは、コマンド2行でインストールが完了する。

# Marketplaceにkepano/obsidian-skillsを追加
/plugin marketplace add kepano/obsidian-skills

# パッケージをインストール
/plugin install obsidian@obsidian-skills

Marketplaceはパッケージの検索・バージョン管理・更新を一元化する仕組みだ。Microsoft APMのようなパッケージマネージャーとの連携も可能で、apm.ymlにkepano/obsidian-skillsを記述すれば、チーム全体に同じスキルセットを配布できる。

パターン2：npx skills

npxを使えば、Gitリポジトリから直接インストールできる。Node.js環境があればどのプラットフォームでも利用可能だ。

# npx skillsコマンドでGitHubリポジトリからインストール
npx skills add [email protected]:kepano/obsidian-skills.git

パターン3：手動インストール（エージェント別）

各エージェントの設定ディレクトリに直接ファイルを配置する方法もある。

Claude Codeの場合

ObsidianのVaultルートに.claudeフォルダを作成し、リポジトリの内容を配置する。

# Vaultルートに移動
cd ~/Documents/MyVault

# .claudeディレクトリを作成
mkdir -p .claude

# リポジトリをcloneして配置
git clone https://github.com/kepano/obsidian-skills.git .claude/obsidian-skills

# Claude Codeを起動すると自動的にスキルを検出
claude

Claude Codeはプロジェクト内の.claude/ディレクトリを自動スキャンし、SKILL.mdファイルを発見するとスキルとして登録する。Claude Codeのベストプラクティス完全ガイドで解説したスキル検出の仕組みがそのまま適用される。

Codex CLIの場合

# Codex CLIのスキルディレクトリにコピー
git clone https://github.com/kepano/obsidian-skills.git /tmp/obsidian-skills
cp -r /tmp/obsidian-skills/skills/* ~/.codex/skills/

OpenCodeの場合

OpenCodeではリポジトリ全体を~/.opencode/skills/に配置する必要がある。skills/フォルダだけをコピーするのではなく、完全なディレクトリ構造を維持する点に注意が必要だ。

# OpenCodeのスキルディレクトリにfull cloneで配置
git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

# OpenCodeはSKILL.mdを自動検出する
# 手動設定ファイルの編集は不要

OpenCodeは起動時に~/.opencode/skills/以下のすべてのSKILL.mdファイルを自動検出する。ディレクトリ構造は以下のようになる。

~/.opencode/skills/
└── obsidian-skills/
    └── skills/
        ├── obsidian-markdown/
        │   └── SKILL.md
        ├── obsidian-bases/
        │   └── SKILL.md
        ├── json-canvas/
        │   └── SKILL.md
        ├── obsidian-cli/
        │   └── SKILL.md
        └── defuddle/
            └── SKILL.md

インストール方法の比較

5つのスキルを徹底解説 — 各SKILL.mdの中身と活用パターン

Obsidian Skillsの5つのスキルは、それぞれ異なる領域をカバーしている。エージェントはタスクの内容に応じて必要なスキルだけを自動的にロードするため、すべてのスキルが常時コンテキストを消費するわけではない。

スキル1：obsidian-markdown — Obsidian Flavored Markdownの完全対応

SKILL.md frontmatter:

name: obsidian-markdown
description: Create and edit Obsidian Flavored Markdown with wikilinks,
  embeds, callouts, properties, and other Obsidian-specific syntax.

このスキルは、Obsidian独自のMarkdown拡張仕様をエージェントに教える。標準的なCommonMark/GFMを拡張する以下の機能をカバーしている。

Wikilinks（内部リンク）:

<!-- 基本リンク -->
[[Note Name]]

<!-- 表示テキスト付き -->
[[Note Name|カスタム表示テキスト]]

<!-- 見出しへのリンク -->
[[Note Name#見出し名]]

<!-- ブロック参照 -->
[[Note Name#^block-id]]

Embeds（埋め込み）:

<!-- ノート全体を埋め込み -->
![[Another Note]]

<!-- 画像埋め込み -->
![[image.png]]

<!-- PDFの特定ページ -->
![[document.pdf#page=5]]

<!-- ノートの特定セクションを埋め込み -->
![[Note#見出し名]]

Callouts（強調ボックス）:

> [!note] タイトル
> ノートの内容

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

> [!tip] ヒント
> 便利な情報

> [!info]+ 折りたたみ可能（デフォルト展開）
> 詳細情報

Properties（YAMLフロントマター）:

---
title: "ミーティングノート"
date: 2026-04-17
tags: [meeting, project-alpha]
aliases: [会議メモ, MTGノート]
cssclasses: [wide-table]
---

このスキルのワークフローは5ステップで構成されている。

1. フロントマターにプロパティを記述
2. 標準Markdown＋Obsidian拡張構文でコンテンツを作成
3. Wikilinksで関連ノートを接続
4. 必要に応じてembedでコンテンツを埋め込み
5. calloutsで重要情報をハイライト

obsidian-markdownスキルがなければ、AIエージェントは[[]]の代わりに[]()形式のリンクを生成し、Obsidianのグラフビューやバックリンク機能が機能しなくなる。

スキル2：obsidian-bases — データベースビューの操作

SKILL.md frontmatter:

name: obsidian-bases
description: Create and edit Obsidian Bases (.base files) with views,
  filters, formulas, and summaries.

Obsidian Basesは、ノートのメタデータをデータベースのように操作できる機能だ。.baseファイルはYAML形式で記述され、テーブル・カード・リスト・マップの4つのビュータイプをサポートする。

フィルタ構文:

# AND条件でタスクを絞り込む例
filter:
  - and:
    - "file.hasTag('task')"
    - "status != 'done'"
    - "priority >= 3"

フォーミュラ（計算プロパティ）:

formulas:
  days_remaining: "if(deadline, (deadline - today()).days, 'No deadline')"
  is_overdue: "if(deadline, deadline < today(), false)"
  progress_label: "if(progress >= 100, 'Complete', progress + '%')"

ビュー設定の例:

# テーブルビューの完全な定義
views:
  - type: table
    name: "タスク一覧"
    filter:
      - and:
        - "file.hasTag('task')"
    order:
      - property: priority
        direction: desc
    properties:
      - name: status
        display: "ステータス"
      - name: priority
        display: "優先度"
      - name: deadline
        display: "期限"
    summaries:
      - property: status
        function: count

4つのビュータイプの使い分けは以下の通りだ。

スキル3：json-canvas — ビジュアルキャンバスの生成

SKILL.md frontmatter:

name: json-canvas
description: Create and edit JSON Canvas files (.canvas) with nodes,
  edges, groups, and connections.

JSON CanvasはObsidianのビジュアルキャンバス機能で、ノード・エッジ・グループで構成される。JSON Canvas Spec 1.0というオープン仕様に準拠している。

4種類のノード:

Canvas ファイルの構造:

{
  "nodes": [
    {
      "id": "a1b2c3d4e5f67890",
      "type": "text",
      "x": 0,
      "y": 0,
      "width": 400,
      "height": 200,
      "text": "## プロジェクト概要\nこのノードはMarkdownを記述できる"
    },
    {
      "id": "f9e8d7c6b5a43210",
      "type": "file",
      "x": 500,
      "y": 0,
      "width": 400,
      "height": 300,
      "file": "Meeting Notes/2026-04-17.md"
    }
  ],
  "edges": [
    {
      "id": "1234567890abcdef",
      "fromNode": "a1b2c3d4e5f67890",
      "toNode": "f9e8d7c6b5a43210",
      "fromSide": "right",
      "toSide": "left",
      "label": "参照"
    }
  ]
}

すべてのノードIDは16文字の16進数で一意でなければならない。エッジのfromNode/toNodeは既存のノードIDを参照する必要があり、json-canvasスキルはこれらのバリデーションルールもエージェントに教える。

スキル4：obsidian-cli — コマンドラインからVaultを操作

SKILL.md frontmatter:

name: obsidian-cli
description: Interact with Obsidian vaults using the Obsidian CLI to read,
  create, search, and manage notes, tasks, properties, and more.

Obsidian CLIは、起動中のObsidianインスタンスに対してコマンドラインから操作を実行する。ノートの読み書き・検索・プロパティ管理・タスク操作に対応する。

基本的なCLI操作:

# ノートを読み取る（Wikilink形式で指定）
obsidian read file="Daily Note"

# 新しいノートを作成（Vault相対パス）
obsidian create path="Projects/NewProject.md" content="## 概要\nプロジェクトの説明"

# Vault内を検索
obsidian search query="meeting agenda"

# プロパティを更新
obsidian property set file="MyNote" key="status" value="in-progress"

# タスクの一覧表示
obsidian tasks list file="Projects/Sprint.md"

# 結果をクリップボードにコピー
obsidian read file="MyNote" --copy

# ファイルを開かずにサイレント実行
obsidian create path="Logs/2026-04-17.md" content="自動生成ログ" silent

CLIのパラメータは=で値を指定し、スペースを含む値はクォートで囲む。改行は\n、タブは\tのエスケープシーケンスを使う。

プラグイン開発でのCLI活用:

obsidian-cliスキルは、プラグイン/テーマ開発のワークフローもカバーしている。コード変更後のリロード、エラーチェック、DOMインスペクション、コンソール出力の確認まで、開発サイクル全体をCLIから実行できる。

# プラグインのリロード
obsidian reload-plugins

# JavaScriptを実行（デバッグ用）
obsidian eval "app.vault.getFiles().length"

# モバイルエミュレーションの切り替え
obsidian toggle-mobile

スキル5：defuddle — Webページからクリーンなマークダウンを抽出

SKILL.md frontmatter:

name: defuddle
description: Extract clean markdown from web pages using Defuddle,
  removing clutter to save tokens.

defuddleは、Webページからナビゲーション・広告・サイドバーなどのノイズを除去し、本文だけをクリーンなマークダウンとして抽出するツールだ。WebFetchで取得するとトークンを大量に消費するページでも、defuddleを通せば本質的なコンテンツだけに絞ってトークンを節約できる。

# インストール
npm install -g defuddle

# Webページをマークダウンに変換
defuddle parse https://example.com/article --md

# ファイルに保存
defuddle parse https://example.com/article --md -o content.md

# メタデータだけ抽出（タイトルなど）
defuddle parse https://example.com/article -p title

出力形式の選択:

defuddleスキルはURLが.mdで終わるページには使わない。すでにMarkdown形式のコンテンツに対してdefuddleを実行すると、フォーマットが壊れる可能性がある。通常のWebページ・ドキュメントサイト・ブログ記事に対して使うのが正しい用途だ。

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

Obsidian SkillsはAgent Skills仕様に完全準拠している。この仕様を理解すると、Obsidian Skillsがなぜこの構造になっているかが明確になる。

Agent Skills仕様の3層構造

Agent Skills仕様は、トークン効率を最大化するために「Progressive Disclosure（段階的開示）」の設計思想を採用している。

Layer 1（常時ロード）: nameとdescriptionだけが起動時にロードされる。Obsidian Skillsの場合、5スキル分で約500トークンだ。エージェントはこのメタデータを見て「このタスクにどのスキルが必要か」を判断する。

Layer 2（オンデマンド）: エージェントがスキルを呼び出すと、SKILL.mdの本文がロードされる。仕様では5,000トークン以下が推奨されている。

Layer 3（必要時のみ）: scripts/、references/、assets/配下のファイルは、エージェントが追加情報を必要と判断した場合にのみ読み込まれる。

SKILL.md frontmatterの仕様

Agent Skills仕様で定義されているfrontmatterフィールドは以下の通りだ。

最小限のSKILL.md:

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

## 手順

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

オプションフィールド付きの例:

---
name: pdf-processing
description: Extract PDF text, fill forms, merge files.
  Use when handling PDFs.
license: Apache-2.0
compatibility: Requires Python 3.14+ and uv
metadata:
  author: example-org
  version: "1.0"
allowed-tools: Bash(git:*) Read
---

30以上のツールが対応するエコシステム

Agent Skills仕様はAnthropicが策定し、オープンスタンダードとして公開された。2026年4月時点で、以下の主要ツールが対応している。

つまり、Obsidian Skillsを一度作成すれば、30以上のエージェントツールでそのまま利用できる。これがAgent Skills仕様の最大の価値だ。ベンダーロックインのない、ポータブルなスキルフォーマットである。

実践ワークフロー — Obsidian SkillsでVault管理を自動化する

Obsidian Skillsを導入した後の具体的なワークフローを紹介する。以下はすべて公式ドキュメントと仕様に基づいた操作例だ。

ワークフロー1：会議ノートの自動生成

Claude Codeに「今日の会議ノートを作成して」と指示すると、obsidian-markdownスキルがロードされ、Obsidian固有の記法で正確にノートを生成する。

---
title: "週次定例 2026-04-17"
date: 2026-04-17
tags: [meeting, weekly]
aliases: [週次MTG 0417]
---

## アジェンダ

> [!note] 前回のアクションアイテム
> - [[Sprint Review#^action-01|UI改修]] — 完了
> - [[Sprint Review#^action-02|API設計]] — 進行中

## 議事内容

### プロジェクトAlpha進捗
![[Projects/Alpha/Status.md#最新状況]]

### 次週のタスク
- [ ] [[Feature Spec A]] のレビュー
- [ ] [[Design Doc B]] の更新
- [x] テスト環境のセットアップ

> [!tip] 決定事項
> リリース日を4月25日に確定。詳細は [[Release Plan 2026Q2]] を参照。

Wikilinks [[]]、embeds ![[]]、callouts > [!type]、タスクチェックボックスがすべてObsidianの仕様通りに生成されている。標準のMarkdownエージェントでは[Sprint Review](Sprint%20Review.md)のような形式になり、Obsidianのバックリンクやグラフビューが機能しない。

ワークフロー2：Basesでプロジェクトダッシュボード

複数のプロジェクトノートをデータベースビューで一覧表示するBaseファイルを、obsidian-basesスキルを使って生成する。

# 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'))"
views:
  - type: table
    name: "アクティブプロジェクト"
    order:
      - property: priority
        direction: desc
    properties:
      - name: status
        display: "ステータス"
      - name: priority
        display: "優先度"
      - name: health_indicator
        display: "健全性"
      - name: days_since_update
        display: "更新日からの日数"
  - type: cards
    name: "プロジェクトギャラリー"
    filter:
      - "status == 'active'"

ワークフロー3：CLIとdefuddleの組み合わせ

Webリサーチの結果をObsidian Vaultに自動取り込みするフローだ。defuddleでWebページからクリーンなマークダウンを抽出し、obsidian-cliでVaultに保存する。

# Step 1: defuddleでWebページをマークダウンに変換
defuddle parse https://example.com/research-article --md -o /tmp/article.md

# Step 2: obsidian-cliでVaultにノートとして保存
obsidian create path="Research/2026-04-17-article.md" \
  content="$(cat /tmp/article.md)" \
  silent

# Step 3: プロパティを追加
obsidian property set file="Research/2026-04-17-article" \
  key="source" value="https://example.com/research-article"
obsidian property set file="Research/2026-04-17-article" \
  key="tags" value="research, imported"

ワークフロー4：JSON Canvasでアーキテクチャ図

コードベースの構造をビジュアルキャンバスとして自動生成する。json-canvasスキルにより、ノードID生成・座標計算・エッジ接続のルールが正確に守られる。

{
  "nodes": [
    {
      "id": "a1b2c3d4e5f60001",
      "type": "text",
      "x": 0, "y": 0,
      "width": 300, "height": 150,
      "text": "## Frontend\nReact + TypeScript\nポート: 3000"
    },
    {
      "id": "a1b2c3d4e5f60002",
      "type": "text",
      "x": 400, "y": 0,
      "width": 300, "height": 150,
      "text": "## API Gateway\nNginx\nポート: 443"
    },
    {
      "id": "a1b2c3d4e5f60003",
      "type": "text",
      "x": 800, "y": 0,
      "width": 300, "height": 150,
      "text": "## Backend\nPython + FastAPI\nポート: 8000"
    },
    {
      "id": "a1b2c3d4e5f60004",
      "type": "group",
      "x": -20, "y": -40,
      "width": 1140, "height": 230,
      "label": "Production Environment"
    }
  ],
  "edges": [
    {
      "id": "e1e2e3e4e5e60001",
      "fromNode": "a1b2c3d4e5f60001",
      "toNode": "a1b2c3d4e5f60002",
      "fromSide": "right",
      "toSide": "left",
      "label": "HTTPS"
    },
    {
      "id": "e1e2e3e4e5e60002",
      "fromNode": "a1b2c3d4e5f60002",
      "toNode": "a1b2c3d4e5f60003",
      "fromSide": "right",
      "toSide": "left",
      "label": "REST API"
    }
  ]
}

従来手法との比較 — Obsidian Skillsがもたらす違い

Obsidian Skillsの導入前後で、AIエージェントのObsidian操作がどう変わるかを比較する。

Skills有無の比較

類似ツールとの比較

Obsidian Skillsの差別化ポイントは、Obsidianの開発元CEOが書いた公式レベルの正確さと、Agent Skills仕様によるマルチエージェント対応の両立にある。個人でCLAUDE.mdにObsidianの記法ルールを書くこともできるが、Basesのフィルタ構文やCanvasのJSON仕様まで網羅するのは現実的ではない。

関連記事: Claude Code完全ガイド2026：インストールから本番運用まで

まとめ：Obsidian SkillsはナレッジワーカーのAgent Skills入門に最適

Obsidian Skillsは、Agent Skills仕様の実践的なリファレンス実装でもある。

• 5つの専門スキル — Markdown、Bases、Canvas、CLI、Web抽出をカバー
• 24.5kスター — Obsidian CEOのkepano氏が自ら開発・メンテナンス
• マルチエージェント対応 — Claude Code、Codex CLI、OpenCode + Agent Skills仕様準拠で30以上のツールに対応
• 3つのインストール方法 — Marketplace、npx、手動の環境に応じた選択肢
• Progressive Disclosure — メタデータ約100トークン、SKILL.md本文は呼び出し時のみロード

Obsidianユーザーにとっては「AIエージェントにVaultを正確に操作させる」ための必須パッケージだ。そしてAgent Skillsに初めて触れる開発者にとっては、仕様の実装例として「SKILL.mdをどう書けばいいか」を学べる格好の教材でもある。

Claude Skillsの仕組みを解説した記事と合わせて読めば、Agent Skillsの設計思想から実装パターンまで一貫して理解できる。自分のワークフローに合わせたカスタムスキルを作る第一歩として、まずはObsidian Skillsのインストールから始めてみるといいだろう。

参照ソース

• 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公式ドキュメント