Communityライティング&編集github.com

steipete/obsidian

Obsidianボールトの操作:ノートの検索・読み取り・書き込み、バックリンク、ベース、キャンバスに対応

obsidian とは?

このスキルは、ローカルのObsidianボールトを操作するための統合インターフェースを提供します。Obsidianボールトとは、Markdownファイルと `.obsidian/` 設定フォルダからなる通常のフォルダです。公式CLIを活用し、ノートの全文検索、内容の読み取り、新規作成、追記、移動などの操作を安全かつ効率的に実行できます。また、バックリンクやリンクの取得、ベース(データベース)のクエリ、キャンバスファイルの操作、プラグイン管理など、Obsidianの高度な機能にも対応しています。ファイルシステムへの直接アクセスとCLIコマンドを適切に使い分けることで、正確性とパフォーマンスを両立し、ボールト全体の整合性を保ちながら作業を進められます。このスキルは、Claude CodeやClineなどのAIエージェント環境で動作し、日常的なノート管理から複雑なワークフロー自動化まで幅広く活用できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/obsidian

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

obsidian は何をしますか?

ローカルのObsidianボールトで作業するために使用します。Obsidianボールトは、Markdownファイルと .obsidian/ 設定フォルダからなる通常のフォルダです。

ソース

  • アプリ設定: ~/Library/Application Support/obsidian/obsidian.json
  • デフォルトのボールト名: obsidian
  • 通常のローカルのボールトパス: ~/obsidian
  • 公式CLI: obsidian
  • ボールトコマンドはカレントワーキングディレクトリ(cwd)からボールトを解決します。~/obsidian から実行してください。

最初の確認

command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:

version や vaults のようなグローバルコマンドは、ボールトの外でも動作します。ボールトコンテンツのコマンドは、~/obsidian の外で実行すると Vault not found. と表示されることがあります。CLIの機能を調べるには obsidian help ではなく obsidian commands を使用してください。

obsidian がCLIが無効と表示する場合:

  1. ユーザーに設定 → 一般 → 詳細設定 → コマンドラインインターフェイス を有効にするよう依頼することを優先してください。
  2. 既にアプリ設定の構造を確認している場合、~/Library/Application Support/obsidian/obsidian.json で "cli": true と設定します。
  3. アプリレベルのCLI設定を変更した後は、Obsidianを再起動してください。

読み取りワークフロー

Obsidianを考慮した検索には公式CLIを優先してください:

cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json

パスが既に分かっており、正確なバイトデータが必要な場合は、直接ファイルシステムからの読み取りを使用してください:

sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"

更新日時やボールトの選択が重要な場合は、どのソースを使用したかを報告してください。

書き込みワークフロー

最も限定された書き込みパスを選択してください:

  • 新規ノート: obsidian create path="Folder/Note.md" content="..."。
  • デイリーノートに追記/先頭追加: obsidian daily:append content="..."。
  • シンプルなノート編集: Markdownファイルに対して apply_patch を使用します。
  • ノートの名前変更/移動: obsidian move path="Old.md" to="Folder/New.md" を優先。これによりリンクが更新されます。
  • 書き込み後にUIを開く: 有益な場合、またはリクエストされた場合にのみ open を追加してください。

一般的なコマンド:

cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"

複数行のコンテンツの場合は、パスが分かったら apply_patch で .md ファイルを編集することを推奨します。長い散文に対して脆弱なシェルクォーティングは避けてください。

ベース、キャンバス、プラグイン

まずはCLIで探索してください:

cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:

.canvas、.base、.json ファイルについては、可能な限り構造化データとして読み取り/編集してください。フォーマットを安定に保ち、編集後はJSONを検証してください。

安全上の注意

  • ボールトを一括で書き換えないでください。対象を絞ったパスを使用し、差分を確認してください。
  • ユーザーから依頼された場合、または明示的に設定/プラグイン作業である場合を除き、.obsidian/ を編集しないでください。
  • 明示的に依頼されない限りノートを削除しないでください。完全削除よりもゴミ箱への移動を推奨します。
  • ObsidianのURI/CLIパスを通じて、隠しドットフォルダのノートを作成しないでください。
  • リファクタリングがタスクでない限り、フロントマターとウィキリンクは保持してください。
  • 複数のボールトが存在する場合は推測せず、obsidian vaults と obsidian.json を使用してください。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル