Communitygithub.com

Obsidian LLM Wiki スキル

Karpathy LLM Wiki を Obsidian で実現:LLM が管理するナレッジベースと Cursor エージェントスキル(wiki, video2wiki)

Obsidian LLM Wiki スキル とは?

このスキルは、Claude Code、Cursor、Codex などの AI エージェントを、ユーザーの個人ナレッジベース(Obsidian ボールト)の規律ある管理者に変えます。エージェントは `AGENTS.md` に定義されたディレクトリ構造、ページ規約、フロントマタースキーマに従い、ユーザーの質問に `[[wikilink]]` で引用しながら回答したり、新しいファイルをインポートして `wiki/index.md` や `wiki/log.md` を更新したり、`wiki lint` で壊れたリンクやスタブをチェックしたりします。スキルは `wiki search`、`wiki stats`、`wiki log`、`wiki lint` の4つの CLI コマンドを提供し、ファイル編集はエージェントが直接マークダウンファイルを読み書きすることで行います。出力は `output/` ディレクトリに LLM 所有・追記専用として保存され、ユーザーは後で知識ベースに昇格できます。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add liyading1818/obsidian-llm-wiki

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

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

ドキュメント

Wiki スキル

このスキルは、エージェントを <VAULT_ROOT>(リポジトリルート)にあるユーザーの個人ナレッジベースの規律ある管理者に変えます。

ステップ 0 — 最初に AGENTS.md を必ず読んでください

何かをする前に、ボールトルートにある AGENTS.md を読んでください。そこにはディレクトリ構成、ページ規約、フロントマタースキーマ、ログ形式、詳細なワークフローが定義されています。この SKILL.md は単なるディスパッチャーであり、AGENTS.md が真実の情報源です。

ディスパッチ:ユーザーは何を求めていますか?

ユーザーのメッセージから、以下の意図を正確に1つ選択してください:

ユーザーの意図ワークフロー
質問をしている、分析・統合を求めているクエリ(以下参照)
新しいファイルをドロップした、または「これを取り込んで」と言った取り込み(AGENTS.md §4.1 参照)
「lint」/「ヘルスチェック」/「問題を探して」と言ったLint(以下参照)
比較・スライドデッキ・グラフ・レポートを求めているアーティファクト生成(以下参照)
探索中、または不明確wiki stats を実行してからユーザーに何をしたいか尋ねる

不明な場合は、先に進む前に短い確認の質問を1つしてください。

クエリワークフロー

  1. リポジトリルートで wiki search <キーワード> を実行して候補ページを見つけます。必要に応じて複数のキーワードバリエーションを使用します。

  2. wiki/index.md を読んでカタログを確認します。

  3. ステップ1で見つけた候補ページを読みます。

  4. それでもコンテキストが不足している場合は、raw/ または clippings/ にある関連ファイルを読みます。

  5. wiki ページへの [[wikilink]] 引用と、元ソースへの [文章](../raw/xxx.md) 引用を使用して回答を統合します。

  6. 回答に永続的な価値がある場合(比較、派生した洞察、重要な統合など)、フロントマター付きのマークダウンファイルとして output/<YYYY-MM-DD>-<短いスラッグ>.md に書き込みます:

    ---
    type: artifact
    kind: answer | comparison | analysis | report | slides
    created: <日付>
    question: "<ユーザーの質問をそのまま>"
    sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...]
    ---
    

    その後、ユーザーに「要不要把这份输出归档为 wiki/questions/<slug>.md?」と尋ねます。(承諾された場合、コピーして index.md と log.md を更新します。)

  7. 回答が自明な場合(事実を調べただけなど)、チャットで回答するだけでファイルは不要です。

Lint ワークフロー

  1. wiki lint を実行します — これにより lint/<今日の日付>.md が自動的に作成されます。
  2. そのファイルを読み、ユーザーに要約します(どの問題が本物で、ドキュメント内のリテラルな [[examples]] のような誤検出はどれか)。
  3. 優先順位付けされた修正計画を提案します。自動修正は行わず、ユーザーに選択させてください。

アーティファクト生成ワークフロー

クエリと同様ですが、成果物の形式が明示的(テーブル / Marp スライド / Python グラフ / キャンバス)です。常に output/ に保存します。スライドデッキには Marp マークダウン形式を使用します。グラフの場合は Python スクリプトを output/scripts/ に書き、実行して画像も生成します。

出力ディレクトリの規約

output/
├── 2026-06-26-rag-vs-llm-wiki.md          # 回答 / 比較アーティファクト
├── 2026-06-26-karpathy-summary.slides.md  # Marp スライドデッキ
├── scripts/                                # グラフ生成用のヘルパースクリプト
└── assets/                                 # レンダリング画像、エクスポート

output/ ディレクトリは LLM 所有、追記専用です(許可なく以前のアーティファクトを削除しないでください)。各ファイルには上記のフロントマターが必要で、ユーザーが後でアーティファクトを wiki に昇格できるようにします。

利用可能な CLI コマンド(<VAULT_ROOT> から実行)

意図的に最小限の4つのコマンドのみ:

wiki stats              # 概要:タイプ/ステータス別のページ数
wiki log -n 10          # wiki/log.md の最後の N エントリ
wiki search <regex>     # 全文検索(--scope wiki|raw|clippings|all)
wiki lint               # lint/<今日の日付>.md に孤立/壊れたリンク/スタブを書き出す

その他の操作(ページ作成、フロントマター編集、index.md 更新、log.md への追記)は、マークダウンファイルを直接読み書きして行います。ファイル編集に CLI を要求しないでください — それはあなたの仕事です。

重要なルール(AGENTS.md より)

  • raw/ または clippings/ 内のファイルは決して変更しないでください。
  • すべての取り込みで wiki/index.md を更新し、wiki/log.md の先頭に ## [YYYY-MM-DD] ingest | <タイトル> 形式のエントリを追加します。
  • wiki ページ間では [[二重ブラケット]] で相互参照します。
  • ページには YAML フロントマター(type、tags、created、updated、sources、status)が必要です。
  • 不明な場合はユーザーに尋ねてください。黙って大規模なリファクタリングを行わないでください。

報告スタイル

ワークフロー完了後、ユーザーに短い概要を報告します:

  • 実行した内容(1〜3箇条書き)
  • 作成または変更されたアーティファクト(相対パス)
  • 未解決の質問や新たに気づいたギャップ

簡潔にまとめてください。ユーザーは並行して Obsidian を閲覧しており、ファイルの変更を確認できます。

関連スキル