
2026/06/13 15:43
Show HN: Agent が gBrain と Obsidian を可視化するためのスキル
RSS: https://news.ycombinator.com/rss
要約▶
Japanese Translation:
このツールは、Obsidian の vault や gbrain エクスポートなど、Markdown ノートのコレクションを、タイムラインのスクラブ機能とクリックして詳細を確認できる自己完結型のインタラクティブ HTML フォース・ディレクテッドグラフに変換します。本ツールは外部サーバー、埋め込み処理、サーバーサイドの依存関係を使わずに完全にローカルで動作し、デフォルトではブラウザベースの Cytoscape ライアウト計算を使用します。オプションとして、大規模なデータセットに対して
networkx、numpy、scipy を使用した事前計算されたグラフも利用可能です。システムはファイル構造を自動的に解釈します:トップレベルフォルダーはテーマ(色)となり、サブフォルダーまたはタグはノードタイプ(形状)を定義し、[[wikilinks]] はエッジを作成し、タイムスタンプがタイムラインを駆動します。インタラクティブな機能には、知識の成長を見守るためのタイムラインのスクラブ、テーマ/タイプごとのフィルタリングとライブカウント、検索、ノードをクリックして詳細パネルを表示するものがあります。ノードサイズはリンク数に基づいてスケールし、中央ハブはラベル付きで表示されます。プリビルトされたデモ(demo/brain-map.html)には、3 つのテーマ(work, study, life)を含む 992 の架空のノートが含まれており、python3 scripts/generate_demo_notes.py を使用して再作成できます。独自のマップを構築するには、python3 scripts/build_map.py <notes_dir> out.html --title "My Second Brain"を実行してください(ここで <notes_dir> は YAML フロントマタータグと [[wikilinks]] を含むディレクトリです)。エージェントスキルとしてのインストールは、Claude Code(~/.claude/skills)、OpenAI Codex(~/.agents/skills)、または Cursor に対して SKILL.md を貼り付けることでサポートされています。プロジェクトディレクトリには、scripts/、プリビルトのデモ、デモ vault のソースノート、オプションの requirements.txt が含まれています。「save-note」といったスキルと相性を考慮し、必要な形状でデータを書き込むよう設計されたこのツールは、外部依存関係なしに個人または組織的な知識システムのための可視化マップの構築を簡素化します。本プロジェクトは MIT ライセンスの下で利用可能です。本文
Brain Map スキル:Markdown の自立したインタラクティブ知識マップ
Obsidian のノートや
gbrain でエクスポートしたフォルダを、1 つの自立したインタラクティブな HTML ナレッジマップに変換します。
主な特徴と機能
- 視覚化: テーマカラーで着色された力导向グラフ(Force-Directed Graph)。
- タイムライン: ベースの成長を見守れるスクロール可能・再生可能なタイムライン。
- 詳細確認: ノードをクリックすると、サマリーや関連ノートの詳細パネルが開く。
互換性のあるツール
このスキルは以下の AI エージェントと相性が良いです:
- Claude Code
- OpenAI Codex
- Cursor
- Gemini CLI
- OpenClaw
- または単にスクリプトを実行するだけでも OK です。
セットアップなしで 5 秒で試す(デモ)
リポジトリには事前構築済みのデモが包含されています。ノート作成や Python の知識も不要です。
マクロシステム別の起動コマンド
open demo/brain-map.html # macOS xdg-open demo/brain-map.html # Linux start demo/brain-map.html # Windows
デモ機能概要
- 架空のノート群: 「仕事」、「勉強」、「生活」の 3 つテーマで構成された 992 ノート。
- インタラクティブな再生: タイムラインをスクロール、プレイボタンで「空→今日」への成長アニメーション確認可能。
- 探索機能: ノードクリックで詳細閲覧、フィルターの切り替えが可能。
自分のノートで構築する
自分の Obsidian Vault または
gbrain エクスポート先をソースとして使用します。
ビルドコマンド
python3 scripts/build_map.py <notes_dir> out.html --title "My Second Brain" open out.html
コマンド引数
: 元のノートディレクトリ(Vault または gbrain 出力)。<notes_dir>
: 出力先ディレクトリ(オプション)。--dir <out>
読み取る情報構造
ビルダーは以下の情報を自動的に分析します:
| 要素 | 役割・解析内容 |
|---|---|
| テーマ | フォルダ名 (, ) → ノードとエッジの色として反映。 |
| タイプ | サブフォルダまたはタグ → ノードの形状(人物、プロジェクトなど)を決定。 |
| エッジ | 解決された → 接続関係を表示(ハブノードはラベル表示)。 |
| タイムライン | 作成日時を月ごとにバケット化 → タイムライン視覚化。 |
依存関係について
- 標準のみ: Python の標準ライブラリ(stdlib)だけで動作し、どこでもすぐにビルド可能。レイアウト計算はブラウザ側(Cytoscape cose アルゴリズム)で担当。
- 高速化オプション:
,networkx
,numpy
を導入すると、1000 ノード以上のマップも瞬時開通し、計算精度が向上します。scipy
ビルダーはライブラリの有無を自動検知して適切な処理経路を選別します。pip install -r requirements.txt
HTML 内での操作方法
- スクロール&再生: グラフが月ごとのノートを表示。「プレイ」ボタンでアニメーション再生可能。
- リアルタイム検索・フィルタ: テーマやタイプでフィルタし、一致項目はハイライト表示。
- 詳細ビュー: ノードクリックで周辺ノードが暗く、対象のみ照らされ、詳細パネル(日付、タグなど)が開く。
- レスポンシブ対応: スマホでも美しく動作します。
エージェントスキルとしてインストールする
AI エージェントにこのスキルを埋め込めます。
インストール方法
1. Claude Code
git clone https://github.com/vladignatyev/brain-map-skill ~/.claude/skills/brain-map
2. OpenAI Codex
git clone https://github.com/vladignatyev/brain-map-skill ~/.agents/skills/brain-map
3. Cursor およびその他エージェント
SKILL.md ファイルをエージェントの説明(プロンプト)に貼り付けるだけで OK です。自立型ファイルのため追加設定は不要です。
ファイル構成
リポジトリの構造例:
brain-map-skill/ ├── SKILL.md # エージェントスキル仕様定義 ├── scripts/ │ ├── build_map.py # Markdown → HTML 変換スクリプト │ └── generate_demo_notes.py # 架空デモノートを生成 ├── demo/ │ ├── brain-map.html # セットアップ不要のデモ HTML │ ├── vault/ # ソースノート (992 ノート) │ └── preview.png # サムネイル画像 ├── requirements.txt # 高速化用依存関係 (オプション) └── LICENSE # ライセンス規定
注意: デモに含まれるすべての人物やイベントは架空であり、実際のデータは使用していません。
ライセンス
MIT License