Obsidian に接続するための Claude スキルを作る：開発者のフィールドガイド

Claude Code を使って、知識ベースとして Obsidian を利用しているなら、おそらく私がぶつかったのと同じ壁に当たっているはずです。つまり、AI エージェントがあなたのボールト（vault）を読めないことです。メモはそこにあるのに、Claude はそれが存在することを知りません。

私たちは Claude スキルのスイートを作ることで解決しました。これは、Claude にネイティブな Obsidian アクセスを提供する、インストール可能なツールバンドルです。以下では、これらがどのようにアーキテクチャ的に動いているのか、そして作って分かったことを説明します。

Claude スキルとは何か

Claude スキルとは、Claude Code の中で動作するポータブルなプロンプト＋ツールバンドルです。インストールすると、特定の領域において Claude ができることを拡張します。スラッシュコマンド（例： /obsidian-cli ）で呼び出すと、Claude は定義されたワークフローを実行します。

スキルは Claw Mart（Claude スキルのマーケットプレイス）から配布されます。インストールは 1 コマンドだけです。

重要なアーキテクチャ上の洞察：スキルは組み合わせ可能です。チェーンできます。たとえば Obsidian CLI スキルが Defuddle スキルを呼び出してウェブページをクリップし、その結果を書き込み先のボールトへ保存します。LLM がオーケストレーションし、スキルがツールを提供します。

Obsidian 統合の問題

Obsidian はすべてを、ローカルのボールトディレクトリ内のプレーンな Markdown ファイルとして保存します。良い知らせは、データベースも API も認証レイヤーもないことです。

課題は、Obsidian が標準 Markdown の上に独自の構文拡張を持っている点です：

• [[wikilinks]] — 不正な形式になると壊れてしまう内部リンク
• ![[embeds]] — 標準の Markdown 画像とは異なるルールで動くファイル埋め込み
• コールアウト — 正確なフォーマットを必要とする > [!NOTE] のブロック
• フロントマター — メタデータ用に Obsidian が解析する YAML プロパティブロック
• .canvas ファイル — ビジュアルマップ用の JSON 形式
• .base ファイル — データベースビュー用の JSON 形式（Obsidian 1.8+ で新登場）

素の Claude に Obsidian ノートを書くよう頼むと、約 60% の確率でこれらを間違えます。wikilinks はブラケットがエスケープされてしまい、コールアウト構文が崩れ、フロントマターの YAML が壊れます。

スキルは、呼び出し時に正確な構文ルールと検証済みテンプレートを注入することで、この問題を解決します。

アーキテクチャ：5 つのスキルが 1 つのまとまりあるスイートになる

1. Obsidian CLI — ボールトの読み書き

基盤となるスキルです。Obsidian を意識した操作により、Claude があなたのボールトに直接アクセスできるようにします。

実現できること：

• タイトルまたはパスで任意のノートを読む
• 正しい Obsidian 構文でノートを作成／更新する
• ボールト内容を検索する（全文、タグ、frontmatter プロパティ別）
• 添付ファイルを管理する
• フォルダ階層をナビゲートする

どのように動くか：
このスキルは Claude Code のネイティブなファイルツール（Read、Write、Glob、Grep）を、あなたのボールトディレクトリにスコープして使用します。外部プロセスは不要で、プラグインも不要です。スキルのプロンプトは、あなたのボールトがどこにあるか、そして安全にナビゲートする方法を Claude に伝えます。

# 例の呼び出し
/obsidian-cli my Projects フォルダに新しいノートを作成し、今日の standup をまとめる

Claude は既存の Project テンプレート（ある場合）を読み取り、正しいフロントマターでノートを作成し、さらにボールト内で見つかる関連ノートを [[wikilinks]] でリンクします。

インストール： shopclawmart.com/listings/obsidian-cli-control-your-vault-from-claude-70417317

2. Obsidian Markdown — 毎回正しい構文

構文を強制するスキルです。ファイル操作は行わず、純粋に「Obsidian Markdown を正しく書く」ことに特化しています。

解決する問題：
Claude の学習データには標準 Markdown が含まれていますが、Obsidian の拡張は普遍的に表現されているわけではありません。LLM はコールアウト構文を推測し、wikilinks が相対パスを使わないことを忘れ、フロントマター YAML を壊してしまうことが頻繁にあります。

このスキルが注入するもの：

• 完全な wikilink 参照： [[Note Title]]、[[Note Title|Display Text]]、[[Note Title#Heading]]
• 正しい構文を持つすべてのコールアウト型： [!NOTE]、[!WARNING]、[!QUOTE] など
• フロントマターのルール：有効なプロパティ型、日付形式、タグ構文
• 埋め込み構文（画像、PDF、その他のノート、見出し向け）
• Mermaid 図のサポート（Obsidian はネイティブにレンダリングします）

インストール： shopclawmart.com/listings/obsidian-markdown-perfect-obsidian-syntax-every-time-a3bc9293

3. Obsidian Bases — AI が作るデータベースビュー

Obsidian 1.8 では Bases が出荷されました。これは、ボールトの上に乗るネイティブなデータベース／スプレッドシート層です。強力ですが、.base ファイル形式は JSON ベースで、クエリモデルの理解が必要です。

このスキルが行うこと：
作りたいビューを、平易な英語で説明します。Claude は有効な .base ファイルを生成し、あなたのボールトへ書き込みます。

# 例
/obsidian-bases タグ #project が付いたすべてのノートを表示するテーブルを作成し、
列として status、due date、最終更新日を含める

出力：正しい JSON スキーマ、フィルター式、カラム定義、そしてサマリー行を備えた .base ファイルです。Obsidian で開けば、データベースビューがすぐに有効になります。

技術的なメモ：
このスキルには、Bases の完全な JSON スキーマ（フィールド型、演算子、数式構文）をコンテキストとして含めています。ここは記憶だけで正しくするのが難しい部分で、スキルによって決定論的に扱えるようにしています。

インストール： shopclawmart.com/listings/obsidian-bases-database-views-without-writing-a-single-query-bfece862

4. JSON Canvas — ボールト内のビジュアルマップ

Obsidian の Canvas 機能は .canvas ファイルを使います。これは、ノード／エッジのビジュアルグラフ用の JSON 形式です。手で作るのは面倒です。スキーマ参照なしで Claude によって作らせると、無効なファイルになってしまいます。

このスキルが行うこと：
概念、図、関係性のマップを説明します。Claude は有効な .canvas ファイルを生成し、ボールトに保存します。

# 例
/json-canvas 取引システムのアーキテクチャを示すキャンバスを作成：
data ingestion → signal generation → risk management → execution → monitoring

出力：配置されたノード、色分けされたグループ、ラベル付きのエッジ、そしてボールト内のノートへの関連する wikilinks を含む .canvas ファイルです。

インストール： shopclawmart.com/listings/json-canvas-visualize-any-idea-as-an-obsidian-canvas-626fa65f

5. Defuddle — Web → クリーン Markdown

リサーチ取り込み用のスキルです。任意の URL を受け取り、ナビゲーション／広告／定型文（ボイラープレート）を取り除いて、ボールトで使えるクリーンな Markdown を生成します。

基になっているもの： Defuddle（Obsidian の作者である Kepano によるもの）。このスキルは CLI を Obsidian 向けの出力フォーマットで包みます。

# 例
/defuddle https://some-article-url — source URL を frontmatter に入れ、
私の Reading/ フォルダに保存する

出力: フロントマターにソースURL、著者、日付、そしてあなたのタグを含む、あなたのボールトにクリーンなMarkdownファイルを作成します。ほかのノートからリンクする準備はできています。

インストール: shopclawmart.com/listings/defuddle-turn-any-web-page-into-clean-markdown-927bcb66

一緒に作るスキル

本当の力は構成（コンポジション）です。こちらが私が実際に回しているワークフローです：

1. /defuddle [URL]           → 記事をraw/にクリップ
2. /obsidian-cli             → それを要約し、Wikiページを作成
3. /obsidian-markdown      → すべての構文が正しいことを確認
4. /json-canvas            → 関連するアイデアにそれを結びつけるコンセプトマップを作成

それぞれのスキルが自分の領域を担当します。Claudeがオーケストレーションします。あなたのボールトは自動的により豊かになります。

配布モデル

5つのスキルはすべてClaw Martにあります： shopclawmart.com

Claw MartはClaudeスキルのマーケットプレイスです。スキルは$3.99〜$4.99の一回限りです。購入後はインストールコマンドが手に入り、どのClaude Codeセッションでもそのスキルを利用できます。

マーケットプレイスは他のスキル作者にも開かれています。役に立つものを作ったなら、そこに配布できます。

次に何をする？

私たちは、より多くのObsidian連携を構築しています：

• デイリーノート自動化 — セッション終了時に自動で要約をあなたのデイリーノートへ書き込む
• 間隔反復（スぺースド・リピティション） — Claudeがあなたのノートからフラッシュカードを生成し、復習する内容を追跡する
• ボールト間検索 — 複数のObsidianボールト（個人＋仕事＋プロジェクト）を持っている場合

あなたがObsidianのパワーユーザーで、Claudeに任せられたら嬉しいワークフローがあるなら、ここに返信するか、ロードマップ上の課題（issue）を開いてください。私たちは実際の利用ケースに基づいて作ります。

試してみる

• フルセット: shopclawmart.com
• 上にある個別のスキルはインラインでリンク済み
• 質問は？ ここに返信するか、Xで私に連絡してください: [@nathanlee_ai]