メインコンテンツへスキップ
見出し画像

Claude CodeにObsidianのノートを正しく書かせる公式スキル集の使い方|obsidianmd obsidian-skills

    Claude CodeなどのAIにObsidianのメモを書かせると、[[ノート名]]のリンクやコールアウトが崩れたり、普通のMarkdownになったりしませんか。Obsidian Skillsを入れると、AIがObsidian独自の書き方やファイル形式を覚えた状態で作業してくれます。Obsidianの開発元が公開しているスキル集で、Claude CodeやCodex、Cursorなどで使えます。

    GitHub:obsidian-skills

    この記事でわかること

    • 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-skills

    Claude Codeを起動している場合は、チャット欄に次のコマンドを入力しても同じです。

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

    あとから新しいスキルを受け取りたい場合は、ターミナルで次のコマンドを実行します。

    claude plugin update obsidian@obsidian-skills

    STEP 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-skills

    Cursorの場合は、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
          - status

    AIへの頼み方の例です。

    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アプリで次の設定をします。

    1. Obsidianの「設定」から「一般」を開く

    2. 「Command line interface」をオンにする

    3. 画面の案内にそってCLIを登録する

    登録したら、ターミナルを開き直して次のコマンドを実行します。コマンドの一覧が表示されれば使える状態です。

    obsidian help

    CLIは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に任せやすくなります。

    参考リンク

    あなたへのおすすめ