AIエージェントにObsidianの使い方を教える!Markdown・Canvas操作を自動化 — obsidian-skills

kepano/obsidian-skills21.1k

obsidian-skillsは、AIエージェント(Claude CodeやCodex CLIなど、自動でコードを書いたり作業してくれるAIツール)に、メモアプリ「Obsidian」の操作方法を教えるためのスキル集です。Obsidian独自のMarkdown記法やデータベース機能(Bases)、図を描くJSON Canvas、コマンド操作(CLI)など、Obsidianの主要機能をAIが正しく理解・操作できるようになります。普段Obsidianでメモや知識管理をしている人が、AIの力を借りてノート作成や整理を自動化したいときに役立ちます。Agent Skills仕様(AIエージェント向けの共通ルール)に準拠しているため、対応するさまざまなAIツールで使えます。

🔥 なぜ話題?

AIコーディングエージェント(Claude Code、Codex CLIなど)の普及が進む中、日常的に使うメモアプリとAIを連携させたいというニーズが急増しています。Obsidianは技術者に人気が高いメモアプリであるため、そのユーザー層とAIエージェント利用者が大きく重なり、注目を集めています。

💡 こう使える!

例えば、Obsidianの保管庫(vault)にたまった数百のメモをAIに整理してもらいたいとき、obsidian-skillsを導入したClaude Codeに『すべてのメモにタグとプロパティを付けて、プロジェクトごとにBasesでまとめて』とお願いすると、Obsidianの書式ルールを正しく守りながら自動でノートを編集・整理してくれます。

ユースケース: Obsidianのメモやデータベースの作成・編集・整理をAIエージェントに任せて自動化する

  • Claude CodeやCodex CLIなど複数のAIエージェントに対応した共通スキル仕様
  • Obsidian独自のMarkdown・Bases・JSON Canvas・CLIの5つのスキルを収録
  • マーケットプレイスやnpxコマンドで簡単にインストール可能
GitHubで見る →

Agent skills for Obsidian. Teach your agent to use Markdown, Bases, JSON Canvas, and use the CLI.

技術情報

ライセンス

MIT

最終更新

2026-04-02

スター数

21,107

フォーク数

1,296

Issue数

22

トピック

claudeclawdbotclicodexdefuddleobsidianopenclawopencodeskills

技術詳細

アーキテクチャ・仕組み

obsidian-skillsはAgent Skills仕様に準拠しており、各スキルは skills/<スキル名>/SKILL.md というMarkdownファイルとして定義されている。AIエージェントがこのSKILL.mdを読み込むことで、Obsidian固有の文法やルールを理解し、正しい形式でファイルを操作できるようになる。

収録スキル一覧

スキル名内容
obsidian-markdownObsidian独自のMarkdown記法(ウィキリンク、埋め込み、コールアウト、プロパティなど)の作成・編集
obsidian-basesObsidian Bases(.baseファイル)のビュー、フィルター、数式、集計の作成・編集
json-canvasJSON Canvas(.canvasファイル)のノード、エッジ、グループ、接続の作成・編集
obsidian-cliObsidian CLI経由でのVault操作、プラグイン・テーマ開発
defuddleDefuddleを使ったWebページからのクリーンなMarkdown抽出(不要な要素を除去しトークンを節約)

対応AIエージェント

  • Claude Code — Anthropicが提供するコーディングエージェント
  • Codex CLI — OpenAIが提供するCLIエージェント
  • OpenCode — オープンソースのエージェントツール
  • その他Agent Skills仕様に対応した任意のエージェント

対応ファイル形式

  • .md — Obsidian Flavored Markdown
  • .base — Obsidian Bases(データベース機能)
  • .canvas — JSON Canvas(ビジュアルキャンバス)

インストール方法の選択肢

  • マーケットプレイス: プラグインコマンドで追加
  • npx skills: Node.jsのnpxコマンドで追加
  • 手動コピー: 各エージェントのスキルディレクトリに配置

注意点

  • OpenCodeで手動インストールする場合は、skills/フォルダだけでなくリポジトリ全体をクローンする必要がある(ディレクトリ構造が ~/.opencode/skills/obsidian-skills/skills/<skill-name>/SKILL.md となる必要があるため)
  • OpenCodeでは設定ファイルの変更は不要で、再起動後に自動的にスキルが認識される

開発者情報

  • 作者: kepano(Obsidianの開発者としても知られる)
  • defuddleスキルはWebページのクリッピング時にトークン(AIが処理するテキストの単位)を節約する目的で設計されている

インストール・クイックスタート

マーケットプレイスからインストール

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

npx skills でインストール

npx skills add git@github.com:kepano/obsidian-skills.git

手動インストール(Claude Code)

リポジトリの内容をObsidian保管庫のルートにある /.claude フォルダにコピーする。

手動インストール(Codex CLI)

skills/ ディレクトリを ~/.codex/skills にコピーする。

手動インストール(OpenCode)

git clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills

※リポジトリ全体をクローンすること(skills/フォルダだけのコピーは不可)。再起動後にスキルが自動認識される。

参考になる外部の関連記事

過去のトレンド履歴

関連リポジトリ

使うほど賢くなるAIエージェント — 学習・記憶・自動化を全部入りで月5ドルから運用 — hermes-agent

NousResearch/hermes-agentPython87.5k

Hermes Agentは、Nous Research社が開発した「自己改善するAIエージェント」です。会話するたびに経験からスキルを自動生成し、ユーザーの好みや過去のやり取りを記憶して、使えば使うほ

AIコーディングエージェントを10体同時に走らせろ!並列開発を実現するターミナル — superset

superset-sh/supersetTypeScript4.6k

Supersetは、Claude CodeやOpenAI Codexなど複数のAIコーディングエージェント(自動でコードを書いてくれるAIツール)を同時並行で動かせる、macOS向けのデスクトップアプ

Claude Codeを「チーム」に進化させる!複数AIエージェント同時稼働のマルチエージェント司令塔 — oh-my-claudecode

Yeachan-Heo/oh-my-claudecodeTypeScript20.1k

oh-my-claudecodeは、Claude Code(AIコーディングアシスタント)を複数のAIエージェントが協力して動く「チーム」に変えるツールです。通常Claude Codeは1つのAIが1

Reddit・X・YouTube・予測市場…10ソースを自動横断してAIが"今の空気"をまとめてくれる調査スキル — last30days-skill

mvanhorn/last30days-skillPython16.1k

last30days-skillは、Claude Code(AIコーディングツール)に追加する「スキル」で、調べたいテーマについてReddit・X(旧Twitter)・YouTube・Hacker N

AIエージェントの「脳」を丸ごと管理!ファイルシステム発想のコンテキストDB — OpenViking

volcengine/OpenVikingPython14.7k

OpenVikingは、AIエージェント(自律的にタスクをこなすAIプログラム)が必要とする「記憶」「資料」「スキル」をまとめて管理できるオープンソースのコンテキストデータベースです。パソコンのフォル