knowledge

Installation
SKILL.md

Knowledge — Obsidian ナレッジ管理

Obsidian vault を Zettelkasten 方式で管理するスキル。調査結果の保存、既存ナレッジの検索、デイリーノート管理、ノートの整理・リンク構築を行う。

Vault

  • vault 名: 環境変数 OBSIDIAN_KNOWLEDGE_VAULT で指定する。CLI には vault="$OBSIDIAN_KNOWLEDGE_VAULT" として渡す
  • 未設定の場合は選択した CLI の vaults で候補を提示し、今回使う vault をユーザーに確認する。あわせて、毎回の確認を省くため OBSIDIAN_KNOWLEDGE_VAULT を設定するよう推奨する
  • vault パスが必要な時(filesystem フォールバックなど)は選択した CLI の vaults verbose の出力から該当 vault 名の行のパスを取得する
  • 関連スキル: obsidian-cli(CLI操作)、obsidian-markdown(Markdown構文)

CLI と filesystem の使い分け

全操作で CLI を優先する。まず command -v obsidian-cli を確認し、あれば obsidian-cli を使う。なければ command -v obsidian を確認して obsidian を使う。Nix 環境では obsidian が GUI 本体を指す場合があるため、この順序を守る。選択した CLI に $OBSIDIAN_KNOWLEDGE_VAULTvault= 引数として渡し、目的のコマンド(search, read, create, append, daily:read, daily:append など)を実行する。

  • 例(obsidian-cli がある場合): obsidian-cli vault="$OBSIDIAN_KNOWLEDGE_VAULT" search query="test"
  • create / append はデフォルトでファイルを開かない。エディタで開きたい時だけ open を付ける

CLI が無い・落ちる・対象コマンドが失敗する場合は filesystem 操作にフォールバックし、vault ディレクトリ内の .md ファイルを直接読み書きする。vault パスは選択した CLI の vaults verbose が使えればその出力から取得し、CLI 自体が使えない場合はユーザーに確認する。書き込みは obsidian-markdown スキルの構文規約に従って frontmatter + 本文を構成し、書き込み権限が無ければユーザー承認を取る。

Installs
9
First Seen
Jul 1, 2026
knowledge — suree33/agent-skills