kepano

obsidian-skills

// 概要

Obsidian-skills は、Obsidian の機能を互換性のある AI エージェントと統合するために設計された専門的なツール群を提供します。これらのスキルは Agent Skills 仕様に準拠しており、Claude Code や Codex CLI といったプラットフォームとのシームレスな連携を実現します。ユーザーは marketplace プラグイン、npx、または手動のディレクトリ設定を通じてこれらのツールをインストールし、自動化されたワークフローを強化できます。

// 技術解説

Obsidian-skills は、 Agent Skills 仕様に準拠することで、 AI エージェントが Obsidian vault と対話するための標準化されたインターフェースを提供します。この設計思想により、 Claude Code 、 Codex CLI 、 OpenCode といった様々なエージェントプラットフォーム間での相互運用性が確保され、開発者はメモ作成や vault 管理タスクを自動化できます。 LLM ベースのエージェントと Obsidian 独自のファイル形式との間のギャップを埋めることで、本プロジェクトは Obsidian 特有の構文や構造との互換性を維持しつつ、高度な自動化を実現します。

// 主要ハイライト

Obsidian-flavored Markdown をサポートし、エージェントが wikilinks 、 callouts 、 properties を含むファイルの作成や編集を行えるようにします。

Obsidian Bases への特化したサポートを含み、 views 、 filters 、 formulas のプログラムによる操作を可能にします。

JSON Canvas 統合を提供し、視覚的なノードベースのダイアグラムや接続の作成と編集を容易にします。

Obsidian CLI を通じて Obsidian vault と直接対話でき、 plugin や theme 開発といった高度なタスクに対応します。

Defuddle ツールを統合して Web ページからクリーンな markdown を抽出することで、不要な情報を削除し token の使用量を最小限に抑えます。

// ユースケース

wikilinks や callouts を含む Obsidian 形式の markdown ファイルの作成および編集

自動化されたエージェントコマンドを通じた Obsidian Bases や JSON Canvas ファイルの管理

Obsidian vault との対話および Defuddle を使用した Web ページからのクリーンな markdown の抽出

// クイックスタート

開始するには、 marketplace コマンド、 npx 、またはリポジトリを手動でエージェントの指定された skills ディレクトリにクローンしてスキルをインストールします。 OpenCode や Claude Code など、選択したエージェントの特定のディレクトリ構造要件に従い、 SKILL.md ファイルが自動的に検出されるようにしてください。インストールが完了すると、エージェントは提供されたスキルを使用して Obsidian vault ファイルと直接対話できるようになります。