vault-setup

vault-setup-skill

インタラクティブなVault設定ツールです。自由記述の質問を1つ行い、ユーザーの役割とフォルダーを推測して、CLAUDE.md と関連スキルへのリンクを含む、ユーザーに合わせたObsidian Vaultを構築します。

ディレクトリ構成

vault-setup-skill/
├── SKILL.md                          # This file (routing + quick ref)
├── RoleTemplates.md                  # Keyword-to-folder mapping table
├── PluginRecommendations.md          # Obsidian plugins by role type
├── Workflows/
│   ├── Setup.md                      # Main 6-step setup flow
│   ├── ImportFiles.md                # File import guidance
│   └── Verify.md                     # Post-setup verification
├── Tools/
│   ├── VaultBuilder.py               # CLI: create, verify, inject-global
│   └── VaultBuilder.help.md          # Tool documentation
└── scripts/
    └── process_docs_to_obsidian.py   # Bulk file import to inbox/

ワークフローの振り分け

意図	ワークフロー	ツール
新しいVaultを設定する	Workflows/Setup.md	Tools/VaultBuilder.py create
既存ファイルをインポートする	Workflows/ImportFiles.md	scripts/process_docs_to_obsidian.py
Vaultの設定を確認する	Workflows/Verify.md	Tools/VaultBuilder.py verify
Vaultをグローバルコンテキストに追加する	Workflows/Setup.md Step 5	Tools/VaultBuilder.py inject-global
Obsidianプラグインを選ぶ	PluginRecommendations.md	—
フォルダーのマッピングを確認する	RoleTemplates.md	—

使用例

"Set up my Obsidian vault"              → Workflows/Setup.md
"I want to create a second brain"       → Workflows/Setup.md
"Import my documents into the vault"    → Workflows/ImportFiles.md
"Verify my vault is set up correctly"   → Workflows/Verify.md
"What plugins should I install?"        → PluginRecommendations.md
"Add this vault to my global config"    → Workflows/Setup.md Step 5

クイックリファレンス

基本フォルダー（常に作成）：inbox/、daily/、projects/、archive/

追加フォルダーはキーワードから検出されます。すべてのマッピングについては RoleTemplates.md を参照してください。

関連スキル（作成されるのではなく、リンクされます）：daily-skill、tldr-skill、obsidian-master-skill

トラブルシューティング

問題	原因	対処方法
VaultBuilder.py の実行時に click が見つからない	依存関係が不足している	pip install click
Vaultフォルダーは作成されたが、Obsidianに表示されない	ObsidianでVaultのルートが指定されていない	Obsidianを開き、→「フォルダーをVaultとして開く」→ Vaultのディレクトリを選択
inject-global は「Already configured」と表示するが、Claudeにコンテキストが表示されない	CLAUDE.md 内のVaultパスが完全には一致していない	~/.claude/CLAUDE.md でVaultのパスを確認してください。解決済みの絶対パスである必要があります
verifyでシンボリックリンクに [BROKEN] と表示される	対象のスキルディレクトリが移動または削除された	シンボリックリンクを再作成します：ln -sf /path/to/skill ~/.claude/skills/skill-name
process_docs_to_obsidian.py でエンコーディングの警告が表示される	ソースファイルにUTF-8以外の文字が含まれている	警告されたファイルを手動で確認してください。必要に応じて iconv でソースのエンコーディングを変換します

エッジケース

• キーワードが空の場合：--role-keywords が空の場合、基本フォルダー（inbox、daily、projects、archive）のみが作成されます
• Vaultのパスが存在しない場合：VaultBuilderが mkdir -p を使って自動的に作成します
• createを2回実行する場合：安全です。フォルダーの作成には exist_ok=True が使われ、CLAUDE.md は上書きされます（カスタマイズしている場合は、先にバックアップしてください）

---

注意事項

• inject-global は絶対パスを使って ~/.claude/CLAUDE.md を変更します： 後でVaultを移動すると、グローバル設定は古いパスを参照したままとなり、Claudeは何も読み込まずに処理を続けます。Vaultを移動した場合は、inject-global を再実行してください。
• create を再実行すると、カスタマイズしたCLAUDE.mdが上書きされます： フォルダーの作成には exist_ok=True が使われるため安全ですが、CLAUDE.md は必ず書き換えられます。Vaultレベルの指示を手動編集している場合は、先にバックアップしてください。
• process_docs_to_obsidian.py はUTF-8以外のファイルを警告のみでスキップします： Latin-1またはWindows-1252のソースファイルは警告が出て、インポートされません。概要レポートでは失敗として扱われないため、件数を信頼する前にstderrで「encoding」を検索してください。
• PAIディレクトリの構成変更で、関連スキルへのシンボリックリンクが壊れます： verifyで [BROKEN] と表示されるのは、シンボリックリンク先が完全に失われた場合のみです。名前が変更されても対象が存在する場合は有効に見えますが、誤ったスキルにルーティングされます。PAIのスキルを再編成した場合は、verifyを再実行してください。
• --role-keywords が空でもエラーにはなりません： 警告なしで基本フォルダー（inbox/daily/projects/archive）のみが作成されます。役割に応じたフォルダーが作成される想定だった場合は、設定時のログで推測されたキーワードを確認してください。
• 「フォルダーをVaultとして開く」を実行するまで、ObsidianにVaultは表示されません： ディレクトリツリーを作成するだけでは不十分です。ObsidianでVaultのルートを明示的に指定する必要があります。新規ユーザーは、Obsidianに空のワークスペースが表示されると、スクリプトが失敗したと思いがちです。