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

research-obsidian-skill(論文・会話をObsidianナレッジベースに変換)

論文や会話を相互リンクされたObsidianナレッジベースに変換するClaude Codeスキル。トピックハブ下に整理された10セクション構成の論文ノートとインライン図を生成します。

research-obsidian-skill(論文・会話をObsidianナレッジベースに変換) とは?

このスキルは、Claude Code上で論文や議論の内容をObsidian vault内の構造化されたノートに変換するためのツールです。特に、紙の論文を10のセクション(平易な要約、背景、既存手法の限界、方法論、実験設定、結果、限界と将来研究、自身の分析と研究機会など)に分解し、インラインの図表とともにファイルします。また、ノート間の[[wikilink]]による相互リンクを必須とし、既存のトピックハブや他のノートと自動的に結合されることで、ナレッジグラフが有機的に成長します。ファイルの保存先はAI管理フォルダに限定され、ユーザーの手書きノートやObsidian設定ファイルは変更しないよう設計されています。このスキルは「/ai-wiki」と「/ai-wiki-full」の2つのコマンドを提供し、後者はトピックハブを自動作成して逆方向リンクも追加します。参照ファイル(vault-guide.md, note-specs.md, figures-diagrams.md, tools.md)を読み込むことで、フォルダ選定、ファイル名規則、図の埋め込み形式、ワークフロー全体を正確に実行できます。自己チェックリストにより、完成したノートがすべての仕様を満たしていることを確認します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add alfredzhang98/research-obsidian-skill

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

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

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

ドキュメント

ai-wiki — ナレッジベースへのファイル投入(軽量版・デフォルト)

「これをノートにして」という指示を、正しい名前・正しいリンクを持つノートとしてAI管理フォルダ内に作成します。

このコマンドはトピックを作成しません。 1つのノートを生成し、既存のノートへの[[wikilink]]が少なくとも1つ必要です。ノートをトピックハブ下に配置し、相互リンクを張るには、/ai-wiki-fullを使用してください。

なぜトピックがデフォルトでオフなのか:すべての論文に専用ハブを作ると、ハブは何も整理しません——単に論文の名前が長くなるだけです。トピックとは研究の方向性であり、論文の主題ではありません。判断基準は references/note-specs.md の「トピックと見なせるもの」にあります。

出力先

このスキルがファイルするものはすべてAI管理フォルダ内に配置されます。

ゾーン扱い方
AI管理フォルダ(<AI_WIKI>/**)作成・編集・移動・リネーム・削除 — 自由に操作可
ユーザーの手書きノートフォルダ読み取りと検索は自由、追記編集は可。削除・リネーム・移動・上書きの前に確認
.claude/rules/、CLAUDE.md静的設定 — ユーザーがClaudeの動作変更を依頼した場合のみ編集。updated:を更新。唯一の動的例外は .claude/rules/active.md
.obsidian/、.trash/アクセスは可能だが操作禁止 — Obsidianの設定を編集するとvaultが破損する可能性あり

権限レベルでブロックしているものはないため、上記の制約は判断に委ねられます。vaultは通常gitリポジトリではありません。手書きノートを誤って上書きした場合、ファイル同期のバージョン履歴からのみ復元可能です。

これらのゾーンから読み取り、要約をAI管理フォルダにファイルすることが、このスキルの目的です。

参照ファイル — 必要に応じて1つだけ読む(4つすべては不要)

ファイル読むタイミング
references/vault-guide.mdどのフォルダに振り分けるかを決める — ルーティングテーブル、ユーザーの典型的な言い回し例、タグ/ウィキリンクモデル
references/note-specs.md論文ノート、学習ノート、トピック計画を作成する — ファイル名、フロントマター、セクション仕様、表現ルール
references/figures-diagrams.mdノートに図が必要な場合 — 抽出コマンド、埋め込み形式、Mermaid記法のルール
references/tools.md入力に対してどのスキルまたはCLIを使うか、およびエンドツーエンドのワークフロー

通常のファイリング(フォルダが一意に決まり、図も不要)にはこれらの参照ファイルは不要です — 以下に示す手順で十分です。

手順

  1. 分類 — references/vault-guide.md のルーティングテーブルから、宛先フォルダを1つだけ選択します。1つのコンテンツに対して1つのフォルダ。横断的な内容はtags:と[[wikilinks]]で表現し、重複コピーは禁止。
    • 未確定、探索的、またはバッチ処理のヒットは、実際のフォルダではなく Inbox/ へ。
    • 2つのフォルダ間で真に曖昧な場合は、質問する — 推測して重複させてはいけません。
  2. 命名 — references/note-specs.md に従い(小文字ケバブケース):
    • 論文 → Research/papers/<筆頭著者姓>-<年>-<2-3キーワードスラグ>.md(このコマンドはトピックを作成しないため、ノートは papers/ の直下に置かれます。 /ai-wiki-full は papers/<topic-slug>/ 内に配置します)
    • 学習 → Research/learning/<トピックスラグ>-<YYYYMMDD>.md
  3. 既存ノートの確認 — 書き込む前に Glob で対象フォルダを検索(論文の場合は Research/papers/**/*.md;トピックごとのサブフォルダに注意)。既存ノートを更新することが、重複を作るよりも優れています。もし既存ノートがあれば、そこにマージし、その旨を伝えます。
  4. 記入 — Templates/ 内の該当するテンプレート(paper-note.md / learning-note.md)を Read し、そのままの位置に記入します。メモリから構造を再構築してはいけません。セクションのガイダンスは references/note-specs.md にあり、テンプレートの {{...}} プロンプトではありません。
    • > [!callout] ブロックは強調システムです — これを維持し、新しいタイプを追加しないでください。
    • 上部のクイックカードは最後に書きます。完成したノートを圧縮したものです。6行が埋められない場合、下のノートは完成していません。
    • S0「この論文が何をするか、平易な言葉で」は必須です:分野の基本は知っているがこの論文は読んでいない人に向けて3〜5文。順序:直面していた状況 → 構築したもの → なぜ機能するか → 得られた結果。このセクションが書けないなら、論文を理解していません — 続行せずに停止して再読してください。
    • 論文ノートは以下の順に答えます:S0 平易な言葉 → S1 背景 → S2 先行研究ができなかったこと → S3-S4 手法と数学 → S5 実行した実験 → S6 結果 → S7 限界と著者の将来研究 → S8 自分の分析と研究機会。
    • S2とS8がこのノートの存在理由です — どちらも一般的な文章で埋めてはいけません。S4の数学は、ノートから再構成可能でなければならず、単に認識可能であるだけでは不十分です。
    • 各S8の機会には4行すべてが必要です(機会 → なぜ未解決か → 最初の実験 → どのトピックにファイルされるか)。「取るに足らない機会 — <理由>」は有効です。捏造は無効です。
    • 専門的な表現:比喩的なラベルは禁止(「この論文の切り口」「評決」「最強の数字」)。表現テーブルは references/note-specs.md を参照。すべての判断は具体的な証拠に基づかなければなりません。
    • 書く前に論文を読んでください。アブストラクトからセクションを埋めてはいけません。セクションのPDFテキストが入手できない場合は、もっともらしい埋め草ではなく {{not available in source}} と記述します。
  5. 図 — references/figures-diagrams.md に従い:論文の図は paper-figures スキルを使って _attachments/paper-figures/<paper-slug>/ に抽出(添付ファイルツリーはフラットに保ち、トピックフォルダにミラーリングしない)、各図が機能を発揮するセクションにインライン埋め込み。
    • 埋め込みプレフィックスはノートの深さに依存します:papers/ 直下では ../../_attachments/...、papers/<topic-slug>/ 内では ../../../_attachments/...。ノートが移動したときに静かに失敗する唯一の項目です — 1つの画像をスポットチェックしてください。
    • 作成者による図は mermaid フェンスを使用します。ASCII アートは禁止です。
  6. リンク(必須、最低1つ) — ノートには既存のノートへの [[wikilink]] が少なくとも1つ必要です:Research/topics/ 内のハブ、別の論文ノート、または学習ノート。
    • 最初に Glob で Research/topics/ と Research/papers/ を検索し、最も近い対象を選び、関係性を1文で述べます(リンクを裸で置かない)。
    • このコマンドはトピックを作成しません。 リンク先が本当に何もない場合は、.claude/rules/active.md にこの分野が新しいことをフラグし、ユーザーに /ai-wiki-full がハブを構築するコマンドであることを伝えます。
    • ノートが既存のトピックに適合する場合、そのトピックのS6リストに前方リンクを追加します — 相互リンクこそがグラフをクラスタにするものです。
  7. 登録 — これが新しい方向性を開く場合、または進行中の作業である場合は、.claude/rules/active.md に1行のポインタを追加し、updated: を更新します。状態をそこにミラーリングしないでください。active.md は、明示的な設定変更リクエストなしにこのワークフローが触れる唯一のルールファイルです。

完了前の自己チェック

  • 書き込まれたすべてのパスがAI管理フォルダ内にある
  • ファイル名がノートタイプの仕様に一致しており、論文ノートは papers/ 直下にある(このコマンドはトピックを作成しない)
  • 埋め込みプレフィックスがノートの深さと一致し、少なくとも1つの画像をスポットチェックした
  • フロントマターが完全(tags: が存在し、具体的であり、単なる research/ ではない)
  • 既存のノートへの [[wikilink]] が少なくとも1つあり、関係性が述べられている
  • 実際のテンプレートファイルから構築され、セクション順序とコールアウトがそのまま保持されている
  • S0の平易な要約が記入済みで、専門用語の羅列ではない
  • クイックカードは最後に書かれている。6行すべてが具体的な記述であり、単独で成立する
  • 納品されたノートに {{placeholder}} が残っていない
  • 比喩的なラベルがない
  • 図はインライン埋め込みされており、最後にまとめて置かれていない
  • 論文ノート: S2は実際の先行手法名とその具体的な失敗を記述。S7は著者記載/自分の意見/著者の将来研究を分離。S8の結論は証拠を引用し、各機会に4行すべてがある
  • 学習ノート: S1はユーザーの質問をそのまま記載。S5には実際の数値例がある
  • ユーザーに書き込んだ正確なパスを伝えた

関連

相互リンク付きのトピックハブを作成または検索するには、/ai-wiki-full を使用してください。 入力タイプに応じたツール選択:references/tools.md。ゾーンルールの詳細:.claude/rules/permissions.md。

関連スキル