Claude＆Codex 用の obsidian‑skills で Obsidian のノートを自動化
obsidian‑skills の紹介
Obsidian エコシステムに深く関わっていて、Claude や Codex も好きなら、すべてのツールを連携させたいと思うでしょう。GitHub プロジェクト
が正にそれを実現しています—Obsidian 用に構築された Agent Skills のオープンソースコレクションです。これらのスキルは以下の構成に基づいています。
- Agent Skills specification（Claude Code や Codex CLI が使用する同じフォーマット）
- Obsidian‑compatible file types（Markdown、Obsidian‑Base、JSON‑Canvas）
- MIT ライセンスで無料・再利用が容易です。
このガイドでは、プロジェクトを採用すべき理由、インストール手順、Claude でノートを作成するハンズ‑オン例を紹介します。
obsidian‑skills が解決する問題は？
- 自動化 – 新しい
.mdファイルを手動で開く代わりに、Claude/Codex にプロンプトを送信すると、ノートが即座に生成されます。 - 一貫性 – Obsidian に書き込むすべてのエージェントが同じスキルスキーマを使用するため、フォーマット、コードブロック、メタデータが統一されます。
- クロスプラットフォーム – Windows、macOS、Linux、クラウドベースのボールトを使用していても、同じスキルセットが機能します。
スキルプラグインがない場合、次の作業が必要になります: - ファイルを手動で編集する - Obsidian の外でカスタムスクリプトを書き、管理する - 各エージェントでファイルパスを手動で管理する
obsidian‑skills を使えば、大部分の作業は自動で処理されます。
インストールパス
1. Obsidian プラグインマーケットプレイス（推奨）
- Obsidian で 設定 → コミュニティプラグイン → ブラウズ を開きます。
- obsidian‑skills を検索します。
- インストール してから 有効化 をクリックします。
これにより、/.obsidian/plugins/obsidian-skills にスキルがインストールされ、Claude と Codex に自動で登録されます。
2. 手動（codex CLI またはローカル Claude 設定用）
- Claude Code –
skills/フォルダをボールトのルートまたは/.claudeにマップしたフォルダにコピーします。 - Codex CLI –
skills/フォルダを~/.codex/skillsディレクトリにドラッグします。
フォルダを配置したら、エージェントを再起動して新しいスキルを読み込みます。
スキルの利用
インストール後、スキルはエージェントが呼び出せる一連の動詞を公開します。以下は Claude に送られたプロンプトの例です:
プロンプト
Use the skill `obsidian-create-note` to create a new note titled "Obsidian‑Skills Demo" with the content: - Introduction - How to install - Quick usage結果 – 新しいファイル
Obsidian‑Skills Demo.mdがボールトに作成され、Obsidian‑Markdown のルールでフォーマットされます。なぜ役立つか？ 話し言葉やテキストでミーティング議事録、リサーチノート、やることリストを作成でき、作成されたファイルは Obsidian のグラフ、バックリンク、コミュニティプラグインにすぐに利用できます。
共通コマンド
| スキル | 例 | 機能 |
|---|---|---|
obsidian-create-note |
Create a new note titled "Project Plan" |
.md ファイルをタイトルブロック付きで作成 |
obsidian-edit-note |
Edit the note "Obsidian‑Skills Demo" to add section “Implementation” |
特定ファイルにテキストを挿入 |
obsidian-list-notes |
List all notes that contain "TODO" |
条件に合うファイル名を返す |
obsidian-create-canvas |
Create a JSON canvas with ID "mindmap" |
Obsidian のビジュアルエディタ用 .canvas ファイルを作成 |
各スキルは Agent Skills spec に準拠しているため、非常にカスタムな動作が必要な場合は独自のスキルラッパーを書き加えることが可能です。
スキルの拡張
リポジトリはオープンソースであるため、新しいアクションをフォークして追加することができます。
skills/内に新しいスキルフォルダを作成します。- name、description、input format を記載した
manifest.jsonを追加します。 handler.py（Python）またはhandler.js（JavaScript）を作り、Obsidian のローカルファイルシステムと通信します。- コミットしてプッシュします。新しいスキルは、仕様に対応したすべてのエージェントから利用可能になります。
コミュニティからの貢献を歓迎します—プルリクエストを送付するか、バグ報告や新機能のリクエストを開いてください。
はじめにチェックリスト
- Obsidian マーケットプレイスからインストール、または
/.claudeにフォルダをコピー - 最初のプロンプトを書いて実行
- ノートが正しく表示され、フォーマットが整っているか確認
-
obsidian-list-notesでスキルリストを探索 - 興奮したら gist を共有する、あるいはチュートリアルを書く
まとめ
Claude、Codex、または Agent Skills 対応エージェントをすでに使用しているなら、obsidian‑skills はノートをファーストクラスのデータオブジェクトとして扱える橋渡しです。数クリックで次のことができます：
- タッチレスでノート作成
- 一貫した Markdown フォーマット
- 音声やチャットからのクイック編集
- Obsidian のパワフルなグラフとコミュニティエコシステムへの統合
GitHub ページへ移動してリポジトリをスタートし、PR を開くか、単にチャットで入力し始めてください。ハッピーノート作りを！