
Claude CodeにObsidianのノートを正しく書かせる公式スキル集の使い方|obsidianmd obsidian-skills
Claude CodeなどのAIにObsidianのメモを書かせると、[[ノート名]]のリンクやコールアウトが崩れたり、普通のMarkdownになったりしませんか。Obsidian Skillsを入れると、AIがObsidian独自の書き方やファイル形式を覚えた状態で作業してくれます。Obsidianの開発元が公開しているスキル集で、Claude CodeやCodex、Cursorなどで使えます。
この記事でわかること
Obsidian Skillsに含まれる7つのスキルと、それぞれでできること
Claude Codeに入れて、最初のノートを作らせるまでの手順
Bases、Canvas、Obsidian CLIなどを目的別に使う方法
使う前に知っておきたい注意点と、追加で必要なもの
情報確認日:2026年11月13日
Obsidian Skillsでできること
Obsidian Skillsは、AIエージェントに「Obsidianでの作業のしかた」を教えるスキル集です。スキルとは、AIが特定の作業をするときに読む手順書のようなものです。中身はSKILL.mdというMarkdownファイルで、プログラムを動かす仕組みではありません。
例えば、Obsidianの保管庫(ノートを保存しているフォルダー)でClaude Codeを開き、「読書メモを作って、関連ノートにリンクして」と頼む場面を考えます。スキルを入れておくと、AIはObsidianのリンク記法やプロパティ(ノート冒頭のメタ情報)の書き方にそって、ノートを作るようになります。
2026年11月13日時点で、次の7つのスキルが入っています。
obsidian-markdown:ウィキリンク、埋め込み、コールアウト、プロパティなど、Obsidian独自のMarkdownを書けます。
obsidian-bases:ノートをデータベースのように一覧表示する「Bases」の設定ファイル(.base)を作れます。
json-canvas:ノートやカードを線でつなぐ「Canvas」のファイル(.canvas)を作れます。
obsidian-cli:起動中のObsidianアプリをコマンドで操作し、ノートの検索や作成ができます。
obsidian-headless:デスクトップアプリなしで、Obsidian SyncやObsidian Publishを動かせます。
defuddle:Webページから広告やメニューを取り除き、本文だけをMarkdownで取り出せます。
knap:JSONやCSVのデータと雛形から、Markdownのノートをまとめて作れます。
このうちMarkdown、Bases、Canvasの3つは、ファイル形式の説明だけでできています。そのため、ほかのツールを追加しなくても使えます。CLI、Headless、Defuddle、Knapの4つは、それぞれ別のツールが必要です。詳しくは「やりたいこと別の使い方」の章で説明します。
Claude Codeに入れて最初のノートを作らせる
ここでは、Claude Codeに入れて、Obsidian形式のノートを1つ作らせるところまで進めます。
STEP 1:必要なものを用意する
必ず必要なものは次のとおりです。
スキルに対応したAIエージェント(Claude Code、Codex、Cursor、OpenCodeなど)
Obsidianの保管庫として使っているフォルダー
あると便利なのが、Obsidianのデスクトップアプリです。作られたノートが正しく表示されるかを確認するのに使います。
STEP 2:スキルをインストールする
Claude Codeの場合は、ターミナルで次の2つのコマンドを順番に実行します。1行目でスキルの配布元を登録し、2行目でスキルを入れます。
claude plugin marketplace add obsidianmd/obsidian-skills
claude plugin install obsidian@obsidian-skillsClaude Codeを起動している場合は、チャット欄に次のコマンドを入力しても同じです。
/plugin marketplace add obsidianmd/obsidian-skills
/plugin install obsidian@obsidian-skillsあとから新しいスキルを受け取りたい場合は、ターミナルで次のコマンドを実行します。
claude plugin update obsidian@obsidian-skillsSTEP 3:入ったかを確かめる
インストールが終わったら、Claude Codeをいったん終了して起動し直します。チャット欄で/pluginと入力すると、プラグインの管理画面が開きます。インストール済みの一覧に「obsidian」があれば準備完了です。
STEP 4:最初のノートを作らせる
Obsidianの保管庫のフォルダーに移動してから、Claude Codeを起動します。
cd ~/Documents/MyVault
claude~/Documents/MyVaultの部分は、自分の保管庫の場所に合わせて書き換えてください。起動したら、チャット欄で次のように頼みます。
「読書メモ」フォルダーに、最近読んだ本のメモを1つ作ってください。
プロパティにtitle、tags、dateを入れて、要点はコールアウトでまとめてください。
関連ノートとして「読書リスト」へのリンクも付けてください。STEP 5:Obsidianで結果を確かめる
Obsidianで保管庫を開き、作られたノートを表示します。次の3点を確認しましょう。
ノートの冒頭にプロパティ欄が表示されている
要点が色付きの囲み(コールアウト)で表示されている
「読書リスト」へのリンクが、クリックできる内部リンクになっている
まだ「読書リスト」というノートがない場合、リンクは未作成のノートへのリンクとして表示されます。
STEP 6:実行前に知っておきたいこと
READMEによると、このプラグインに入っているのはスキルだけです。MCPサーバー、フック、バックグラウンドで動く処理は含まれていません。
ただし、AIに保管庫のノートについて尋ねると、その内容は会話に取り込まれます。取り込まれた内容は、自分のパソコンの中だけでなく、利用しているAIモデルでも処理されます。仕事のメモや個人的な日記など、外に出したくない情報がある保管庫では注意してください。
Claude Code以外で使う場合
Codexの場合は、ターミナルで次のコマンドを実行します。そのあと、CodexかChatGPTのデスクトップアプリのプラグイン画面から「Obsidian」をインストールします。
codex plugin marketplace add obsidianmd/obsidian-skillsCursorの場合は、Cursor MarketplaceからObsidianをインストールします。
複数のAIツールにまとめて入れられる「npx skills」を使う場合は、次のコマンドです。
npx skills add https://github.com/obsidianmd/obsidian-skills手作業で入れる方法もあります。Claude Codeでは、リポジトリのplugins/obsidian/skills/フォルダーを、保管庫の.claude/skills/にコピーします。Codexでは、同じフォルダーをスキルの保存先(通常は~/.agents/skills)にコピーします。
やりたいこと別の使い方
スキルは、頼んだ内容に合わせてAIが自動で選んで使います。ここでは、目的ごとにどのスキルが働くかと、頼み方の例を紹介します。
ノートをObsidianの書き方で書かせたい
担当するのはobsidian-markdownです。Obsidianでよく使う次のような書き方を、AIが正しく使えるようになります。
[[ノート名]]
[[ノート名|表示する文字]]
![[画像.png]]
> [!tip] ポイント
> ここに要点を書く1行目と2行目はノート同士をつなぐウィキリンク、3行目は画像の埋め込みです。4行目からは、色付きの囲みで目立たせるコールアウトです。
スキルには、細かい注意点も書かれています。例えば、別名(aliases)だけでリンクを書いても解決されないため、[[ノート名|別名]]の形で書く、といったルールです。AIがうっかり間違えやすい部分をスキルが補ってくれます。
頼み方の例は次のとおりです。
この会議メモを整理して、決定事項はコールアウト、参加者は[[人物名]]のリンクにしてください。ノートを表やカンバンで一覧したい
担当するのはobsidian-basesです。Basesは、ノートのプロパティをもとに、表やカードの形で一覧表示するObsidianの機能です。設定は.baseという拡張子のYAMLファイルに書きます。
スキルには、表示形式としてtable(表)、cards(カード)、list(リスト)、map(地図)、kanban(カンバン)の5種類が書かれています。例えば「bookタグの付いたノートを表で一覧する」設定は、次のような形になります。
filters:
and:
- 'file.hasTag("book")'
views:
- type: table
name: "読書リスト"
order:
- file.name
- statusAIへの頼み方の例です。
bookタグの付いたノートを、statusごとに分けたカンバンで表示する.baseファイルを作ってください。Basesを使うには、Obsidianの設定の「コアプラグイン」でBasesが有効になっている必要があります。また、スキルの説明によると、カンバン表示にはObsidian 1.14以降が必要です。
アイデアを線でつないだ図にしたい
担当するのはjson-canvasです。Canvasは、ノートや文字のカードを自由に並べて、線でつなげるObsidianの機能です。ファイルの中身は、JSON Canvasという公開された形式のJSONです。
スキルには、カードの種類(文字、ファイル、Webリンク、グループ)や、線のつなぎ方、配置のルールがまとめられています。マインドマップやフローチャートを作りたいときに便利です。
「新しいブログの企画」を中心に、ネタ・読者・公開スケジュールの3つに分けたマインドマップを.canvasで作ってください。起動中のObsidianを操作したい
担当するのはobsidian-cliです。Obsidian CLIは、Obsidianアプリをターミナルから操作するための公式のコマンドです。ノートの検索、作成、プロパティの変更、デイリーノートへの追記などができます。
使う前に、Obsidianアプリで次の設定をします。
Obsidianの「設定」から「一般」を開く
「Command line interface」をオンにする
画面の案内にそってCLIを登録する
登録したら、ターミナルを開き直して次のコマンドを実行します。コマンドの一覧が表示されれば使える状態です。
obsidian helpCLIはObsidianアプリが起動している必要があります。AIに「保管庫からTODOを含むノートを探して」と頼むと、AIがスキルにそってobsidian searchなどのコマンドを組み立てます。
スキルには、AIが失敗しやすい点の注意も書かれています。
コマンドが失敗しても終了コードは0になるため、出力を読んで成否を判断する
ファイルの移動や名前変更はmvではなくrenameやmoveを使い、リンクを自動で更新させる
deleteはゴミ箱へ移動させ、完全削除は頼まれたときだけにする
WSL(Windows上でLinuxを動かす機能)から使う場合は、スキルの説明によると、Windows側のインストールフォルダーにあるObsidian.comを実行します。Obsidian.exeでは何も出力されずに終了してしまうためです。
プラグインやテーマを開発している人向けに、プラグインの再読み込みやエラー確認、スクリーンショット取得などの開発用コマンドの手順も含まれています。
Webページの本文をノートに取り込みたい
担当するのはdefuddleです。Defuddleは、Webページから広告やナビゲーションを取り除き、本文だけをMarkdownにするツールです。AIに読ませる文字数が減るので、やり取りの量の節約にもなります。
このスキルを使うには、Defuddleのコマンドが必要です。入っていない場合、スキルの指示にそって、AIがインストールしてよいかを先に確認します。
このURLの記事を本文だけMarkdownにして、「クリップ」フォルダーにノートとして保存してください。データから大量のノートを作りたい
担当するのはknapです。Knapは、雛形(テンプレート)とJSONなどのデータを組み合わせて、Markdownを作るツールです。例えば、本のリストのCSVから、1冊ずつ読書メモのノートをまとめて作るといった使い方ができます。
KnapにはNode.js 20以降が必要です。Defuddleと同じく、入っていない場合はAIがインストールの前に確認します。
サーバーやCIで同期・公開したい
担当するのはobsidian-headlessです。Obsidian Headlessは、デスクトップアプリなしでObsidian SyncやObsidian Publishを使うための公式ツールです。2026年11月13日時点ではオープンベータとして提供されています。
使うには、Node.js 22以降と、Obsidian SyncまたはObsidian Publishの有料プランが必要です。ログインにはメールアドレス、パスワード、2段階認証のコードが必要です。スキルでは、AIにパスワードを渡さず、利用者が自分のターミナルでob loginを実行するよう指示しています。
ob loginスキルには、安全に使うための注意も多く書かれています。例えば、同じ端末でデスクトップアプリのSyncとHeadlessのSyncを同時に使わないこと、最初の同期の前に保管庫をバックアップすることなどです。
公式のスキル集が生まれた背景
Obsidian Skillsは、Agent Skillsの仕様にそって作られています。この仕様に対応したAIエージェントなら、同じスキルを共通で使えるのが特徴です。
リポジトリの最初のコミットは2026年1月2日で、作者はSteph Ango(kepano)さんです。もともとは個人のアカウント(kepano/obsidian-skills)で公開されていました。2026年11月11日に、インストール用のコマンドがObsidianの公式アカウント(obsidianmd)を指すように変更され、同じ日にバージョン1.2.0になっています。
1.2.0では、obsidian-headlessスキルの追加や、Basesのカンバン表示への対応などが行われました。ネットで見つかる古い記事では、kepano/obsidian-skillsのコマンドが紹介されていることがあります。新しく入れる場合は、READMEに書かれたobsidianmd/obsidian-skillsのコマンドを使いましょう。
ライセンスはMITライセンスです。
使う前の注意点と向いている人
注意点
1つ目は、保管庫の内容がAIに送られることです。STEP 6で説明したとおり、AIに見せたノートはAIモデルで処理されます。
2つ目は、一部のスキルでは追加のツールや有料プランを用意する必要があることです。CLIはObsidianアプリとCLIの有効化、HeadlessはNode.js 22以降とSyncまたはPublishの有料プランが必要です。
3つ目は、AIが保管庫のファイルを書き換えることです。大事な保管庫で試す前に、バックアップを取るか、試し用の保管庫で動きを確かめると安心です。
4つ目は、更新が活発なことです。2026年11月にも大きな更新があり、スキルの名前や構成が変わっています。定期的にclaude plugin update obsidian@obsidian-skillsで更新しておきましょう。
向いている人
Obsidianでメモを管理していて、AIに整理や下書きを手伝ってほしい人
Claude CodeやCodexを使っていて、ノートの書式崩れに困っている人
Obsidianのプラグインやテーマを開発している人
サーバーで保管庫の同期や公開を自動化したい人
一方、Obsidianを使っていない人には、得られるものはあまりありません。また、CLIやHeadlessのスキルを使うには、ターミナルの基本操作に慣れておく必要があります。
まとめ
Obsidian Skillsは、AIエージェントにObsidianの書き方と操作方法を教える公式のスキル集です。
Markdown、Bases、Canvasの3つは、入れるだけですぐ使える
CLI、Headless、Defuddle、Knapは、それぞれ追加のツールが必要
Claude Codeなら2つのコマンドでインストールできる
保管庫の内容はAIモデルで処理されるので、扱う情報に注意する
まずは試し用の保管庫でClaude Codeを起動し、ノートを1つ作らせてみてください。Obsidianで開いたときにリンクやコールアウトがそのまま使える形になっていれば、日々のメモ整理をAIに任せやすくなります。