Obsidian Skillsとは何ですか？

Obsidian CEOのkepano氏が開発した、AIエージェントにObsidianの操作方法を教えるAgent Skillsパッケージです。obsidian-markdown、obsidian-bases、json-canvas、obsidian-cli、defuddleの5つのスキルで構成されています。

どのAIエージェントに対応していますか？

Claude Code、OpenAI Codex CLI、OpenCodeに対応しています。Marketplace、npx、手動インストールの3つの方法でセットアップできます。

Obsidian Skillsは無料で使えますか？

はい。MITライセンスのオープンソースソフトウェアで、完全無料で利用できます。GitHub上で24.5kスターを獲得している人気プロジェクトです。

Agent Skills仕様とは何ですか？

Anthropicが策定したオープン仕様で、AIエージェントに専門知識やワークフローを教えるためのフォーマットです。SKILL.mdファイルにメタデータと手順書を記述し、フォルダ単位で管理します。Claude Code、Cursor、GitHub Copilotなど30以上のツールが対応しています。

5つのスキルをすべてインストールする必要がありますか？

いいえ。パッケージとして一括インストールされますが、エージェントはタスクに応じて必要なスキルだけを自動的に読み込みます。不要なスキルがコンテキストを消費することはありません。

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

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つのスキルが含まれている。

スキル名	機能	対象ファイル
obsidian-markdown	Obsidian Flavored Markdownの作成・編集	`.md`
obsidian-bases	データベースビューの作成・編集	`.base`
json-canvas	ビジュアルキャンバスの作成・編集	`.canvas`
obsidian-cli	Vault操作・プラグイン開発	CLI
defuddle	Webページからクリーンなマークダウン抽出	Web URL

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が直接スキルを書くことで、公式仕様との完全な整合性が保証されている。

この章のポイント
Obsidian Skills = Obsidian CEO自ら開発した5つのAgent Skills（24.5kスター）
Wikilinks・Bases・Canvas・CLI・Web抽出をAIエージェントに正確に教える
Agent Skills仕様準拠 — SKILL.mdフォルダ形式で、Claude Code・Codex CLI・OpenCodeに対応

インストール方法 — 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

インストール方法の比較

方法	前提条件	更新方法	適したケース
Marketplace	対応エージェント	コマンド1行	チーム開発・継続的な更新
npx skills	Node.js	再実行	Node.js環境がある個人開発者
手動（Claude Code）	Git	`git pull`	Vaultごとにカスタマイズしたい場合
手動（Codex CLI）	Git	手動コピー	Codex CLI専用環境
手動（OpenCode）	Git	`git pull`	OpenCode専用環境

APMとの併用
チーム全体でObsidian Skillsを標準化するなら、apm.yml に kepano/obsidian-skills を依存関係として記述し、apm install で一括配布するのが最も効率的だ。新メンバーは git clone → apm install の2ステップだけでスキル環境が完成する。

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ステップで構成されている。

フロントマターにプロパティを記述
標準Markdown＋Obsidian拡張構文でコンテンツを作成
Wikilinksで関連ノートを接続
必要に応じてembedでコンテンツを埋め込み
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つのビュータイプの使い分けは以下の通りだ。

ビュータイプ	用途	必要なプロパティ
table	タスク管理・データ一覧	なし（任意）
cards	ギャラリー表示・ポートフォリオ	なし（画像推奨）
list	シンプルな列挙	なし
map	位置情報の可視化	latitude, longitude + Mapsプラグイン

スキル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種類のノード:

ノードタイプ	用途	主要属性
text	Markdownテキスト	`text`
file	Vault内ファイルの参照	`file`, `subpath`
link	外部URLの埋め込み	`url`
group	他ノードのグルーピング	`label`, `background`

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

出力形式の選択:

フラグ	出力形式	用途
`--md`	Markdown	Obsidianノートとして保存
なし	JSON	プログラムから処理
`-p title`	特定プロパティ	メタデータ抽出

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

5スキルの使い分け
obsidian-markdown — 日常的なノート作成・編集の基盤スキル
obsidian-bases — データベース的な情報整理（タスク管理・プロジェクト管理）
json-canvas — ビジュアルシンキング・マインドマップ・アーキテクチャ図
obsidian-cli — 自動化・バッチ処理・プラグイン開発
defuddle — Web情報の取り込み・リサーチ・クリッピング

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

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

Agent Skills仕様の3層構造

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

graph TB subgraph Layer1["Layer 1: メタデータ（約100トークン）"] M["name + description
起動時に全スキル分ロード"] end subgraph Layer2["Layer 2: 手順書（5000トークン推奨）"] S["SKILL.md本文
スキル呼び出し時のみロード"] end subgraph Layer3["Layer 3: リソース（必要時のみ）"] R1["scripts/
実行可能コード"] R2["references/
詳細ドキュメント"] R3["assets/
テンプレート・画像"] end M -->|"エージェントがタスクに
マッチすると判断"| S S -->|"追加情報が
必要な場合のみ"| R1 S -->|"追加情報が
必要な場合のみ"| R2 S -->|"追加情報が
必要な場合のみ"| R3 style Layer1 fill:#e8f5e9,stroke:#4caf50 style Layer2 fill:#fff3e0,stroke:#ff9800 style Layer3 fill:#e3f2fd,stroke:#2196f3

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フィールドは以下の通りだ。

フィールド	必須	制約
`name`	はい	最大64文字。小文字・数字・ハイフンのみ。先頭/末尾ハイフン不可
`description`	はい	最大1024文字。スキルの機能と使用タイミングを記述
`license`	いいえ	ライセンス名またはライセンスファイルへの参照
`compatibility`	いいえ	最大500文字。環境要件（必要なツール、ネットワーク等）
`metadata`	いいえ	任意のキー・バリューマッピング
`allowed-tools`	いいえ	スペース区切りの事前承認ツールリスト（実験的）

最小限の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月時点で、以下の主要ツールが対応している。

カテゴリ	対応ツール
ターミナルエージェント	Claude Code, OpenAI Codex, Gemini CLI, OpenCode, Goose, VT Code
IDE統合	Cursor, VS Code (Copilot), Kiro, TRAE, Roo Code, Amp
プラットフォーム	GitHub Copilot, Junie (JetBrains), Firebender, Piebald
エンタープライズ	Snowflake Cortex Code, Databricks Genie Code, Factory, Ona
フレームワーク	Spring AI, Letta, Laravel Boost, OpenHands

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

Agent Skills仕様のメリット
Progressive Disclosure — メタデータ→手順書→リソースの3段階でトークンを節約
ポータビリティ — 1つのSKILL.mdが30以上のツールで動作
シンプルさ — フォルダ＋Markdownだけ。プログラミング不要
バージョン管理 — Gitでそのまま管理・チーム共有できる

実践ワークフロー — 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"
    }
  ]
}

Canvasの座標系
JSON Canvasの座標はピクセルベースで、X軸は右方向に増加、Y軸は下方向に増加する。ノードが重ならないよう、width + 間隔（100px程度）を次のノードのx座標に加算するのが基本パターンだ。

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

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

Skills有無の比較

操作	スキルなし（汎用LLM）	Obsidian Skills導入後
内部リンク	`[Note](Note.md)` — グラフビュー非対応	`[[Note]]` — バックリンク・グラフ完全対応
画像埋め込み	`![](images/photo.png)`	`![[photo.png]]` — Vault内管理
Callout	`> 注意: テキスト`	`> [!warning] テキスト` — 折りたたみ対応
Baseファイル	生成不可	フィルタ・フォーミュラ付きで正確に生成
Canvasファイル	生成不可	16桁HexID・座標・エッジ接続を仕様通り生成
CLI操作	Vault構造を手動で解析	`obsidian read/create/search`で直接操作
Web取り込み	全HTML取得（トークン大量消費）	defuddleで本文のみ抽出（トークン節約）

類似ツールとの比較

ツール	対象	Agent Skills準拠	スキル数	開発元
Obsidian Skills	Obsidian全般	はい	5	kepano（Obsidian CEO）
anthropics/skills	汎用開発	はい	複数	Anthropic
microsoft/apm	パッケージ管理	間接的	—	Microsoft
カスタムCLAUDE.md	個別設定	いいえ	—	個人

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

導入判断のチェックリスト
以下に2つ以上該当するなら、Obsidian Skillsの導入効果が高い。
- ObsidianをメインのナレッジベースとしてWikilinksを活用している
- AIエージェント（Claude Code等）でノート作成・整理を自動化したい
- BasesやCanvas機能を使っている
- Webリサーチ結果をVaultに効率的に取り込みたい
- チームでObsidian Vaultを共有しており、エージェント設定を統一したい