msquared/ブレインリンキング

新規または更新されたノートをObsidianやMarkdownのナレッジボールトグラフに自動的にリンクし、孤立したノートを防ぎます。ノートやミーティングサマリー、インボックスアイテム、関連ページを作成・編集する際に使用します。

ブレインリンキング とは?

このスキルは、Obsidianボールトまたは`[[wikilinks]]`を使用するMarkdownナレッジベース向けに設計された、ノートリンク管理エージェントです。すべてのノートが少なくとも2つの既存ページにリンクし、少なくとも1つの既存ページがそのノートにリンクを張り返すことを必須とすることで、孤立ノート(orphan)を防止します。このスキルは、特定の個人のファイルに依存せず、任意のボールトスキーマに適応します。ノート作成前に`CLAUDE.md`などのルートスキーマファイルを読み込み、`rg`コマンドで既存コンテンツを検索し、重複を防ぎます。また、各ノートに「アップリンク」(親ハブへのリンク)と「サイドウェイリンク」(関連ページへのリンク)を必須とし、人物やプロジェクトはプレーンテキストではなく常に`[[Name]]`形式でリンクすることを推奨します。ミーティングノートやトランスクリプト、生データファイル(`_raw/`フォルダ内)など、さまざまなノートタイプに特化したリンクルールを提供し、共有インボックスへの書き込みや、機密情報の除外など、実用的なガイドラインも含んでいます。このスキルはClaude Codeや類似のAIエージェントプラットフォームで使用することを想定しており、ユーザーがノートを作成・編集するたびに実行することで、ボールト全体のグラフ構造を健全に保ちます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/themsquared/agent-skills/tree/HEAD/skills/brain-linking

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

ドキュメント

ブレインリンキング は何をしますか?

ボールトはグラフです。リンクのないノートは迷子です。作成するすべてのノートは、少なくとも2つの既存ページに接続し、少なくとも1つの既存ページがそのノートに戻るリンクを持つ必要があります。

このスキルは、[[wikilinks]]を使用するObsidianボールトまたはMarkdownナレッジベース向けです。特定の個人のファイルに依存するものではありません。

書き始める前に

  1. ルートにあるボールトスキーマを読んでください。一般的なファイル名: CLAUDE.md、AGENTS.md、README.md。存在する場合はそのファイルに従ってください。
  2. 既存のものを検索します: rg -il '<トピックまたは名前>' --glob '*.md'。
  3. そのトピックのページが存在する場合は、それを編集するか(またはそれを指すインボックスノートを追加する)、追記してください。ほぼ重複するページを作成しないでください。

すべてのノートに必要なもの

  • アップリンク: 親ハブへの [[link]] を1つ。例: 人物やプロジェクトの [[index]] や [[status]]、[[concepts/...]] ページ、プロジェクトハブ、エリアハブ。

  • サイドウェイリンク: 既に存在する関連する人物、プロジェクト、製品、概念、ミーティングへの [[link]] を少なくとも1つ。

  • 人物や物事はリンクとして、プレーンテキストではない: 人物、製品、またはプロジェクトにページがある場合は [[名前]] と書きます。まだページがないが、あるべき場合は、それでもリンクしてください。Obsidianは未作成リンクを表示し、メンテナーがページを作成します。

  • フロントマター: about、area、source、suggested_home、date、agent。area にはボールトが既に使用している値(多くの場合、仕事と生活、またはボールト独自のエリアリスト)を使用します。

  • 下部に「関連」セクション:

    ## 関連
    - [[parent-hub]]
    - [[sibling-or-person]]
    

リンクターゲット

  • 既存の正確なファイル名(ケバブケース)を使用します。リンクする前に rg --files | rg <スラッグ> で確認してください。
  • 大量の弱いリンクよりも、少数の強いリンクを優先します。読者が実際に次にクリックするであろうリンクを選んでください。
  • 日付ページ、デイリーノート、またはタグのみにリンクしないでください。それらはトピックを接続しません。

ミーティングと録音ノート

ミーティングや録音ノートは、以下にリンクします:

  • それが対象とする人物、チーム、またはプロジェクト
  • ページを持つ各参加者
  • それが生み出した概念や判断

リンクがゼロのトランスクリプトは、最も一般的な孤児ノートです。

生データソース

_raw/(またはボールトの同等のキャプチャフォルダ)内のファイルは決して編集しません。それらの内部にリンクを追加しないでください。代わりに、それらを引用するサマリーまたはミーティングページが生ファイルにリンクするため、そのページを通じてグラフに参加します。

共有インボックスへの書き込み(ボット)

  • ボールトが _agents/inbox/(または別のインボックスパス)にのみ書き込むように指示している場合は、それに従ってください。
  • 上記のリンクルールはインボックスノートにも適用され、suggested_home は実在するページを指定する必要があります。

ボールトに絶対に入れてはいけないもの

  • 認証情報、トークン、またはシークレット
  • 共有グラフに属さないプライベートな連絡先詳細
  • 医療記録やその他の機密性の高い個人データ
  • 保存を許可されていない第三者機密資料

終了前のクイックチェック

  • 少なくとも1つのアップリンクと1つのサイドウェイリンクがあり、すべて実在のファイル(または意図的な新しいページ)へのリンクであること
  • 人物、製品、プロジェクトの名前がリンクされていること
  • 「関連」セクションが存在すること
  • 既存ページの重複がないこと

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル