vault-cleanup-auditor

vault-cleanup-auditor skill の概要

vault-cleanup-auditor でできること

vault-cleanup-auditor skill は、Claude Code で Obsidian vault を監査し、日付付きのクリーンアップレポートを作成します。古くなった下書き、未完成のノート、重複ファイル名、空のフォルダを見つけ、すぐに対応できる優先順位付きのレビューにまとめます。

どんな人に向いているか

vault-cleanup-auditor skill は、個人またはチームの vault が増え続けていて、その都度の一発プロンプトではなく、再現性のあるクリーンアップを回したい人に向いています。すでに vault の構造はあるものの、整理のズレや不要なもの、最後まで書き切られなかった内容を素早く見つけたい人に特に有効です。

何が違うのか

これは、単に「ノートを整理して」という汎用プロンプトではありません。vault-cleanup-auditor guide は、固定された監査ワークフロー、明示的な入力要件、保存されるレポートファイルを前提に設計されています。そのため、主観的なノート再編成よりも、定期メンテナンスや Workflow Automation に向いています。

vault-cleanup-auditor skill の使い方

vault-cleanup-auditor のインストールとセットアップ

vault-cleanup-auditor skill を Claude Code にインストールし、Obsidian vault のルートを指定します。必要な基本入力は、vault 内のフォルダではなく、vault 全体の絶対パスです。これを省略した場合、skill は実行前に不足しているパスを尋ねる設計になっています。

監査を開始する方法

vault-cleanup-auditor の使い方として実用的なプロンプトは、短く具体的で十分です。
Run the Vault Cleanup Auditor skill against my vault at /path/to/vault.

skill 側で確認対象はすでに決まっているため、通常はこれで足ります。vault に特殊なサブフォルダ構成がある場合や、一部だけを見たい場合は、最初にその条件を明示してください。そうしないと、監査範囲が広すぎたり狭すぎたりすることがあります。

まず読むべき内容

vault-cleanup-auditor のインストール確認では、まず SKILL.md と SKILL-OC.md を読みます。SKILL.md では、入力フェーズと 4 つのチェックに注目すると、実際に何が起こるのかを正確に把握できます。GitHub repo のファイルツリーもあわせて見て、補助パスを確認してください。ただし、この skill には解釈すべき追加の rules/、resources/、スクリプトはありません。

よりよい出力を得るための入力

vault-cleanup-auditor の使い方として、最も質の高い入力は、きれいな絶対パスと、自分のワークフローで「散らかっている」とは何を意味するかの明確な定義です。たとえば、30 日以上前の下書きを古いものとして扱うのか、アーカイブ済みコンテンツを無視するのか、セクションをまたぐ重複ファイル名を許容するのかを指定します。こうした条件を足すことで、誤検知が減り、レポートの実用性が上がります。

vault-cleanup-auditor skill の FAQ

vault-cleanup-auditor は Obsidian 専用ですか？

はい、この skill は Obsidian vault の構成を前提にしており、ローカルの markdown ファイルを想定しています。他のフォルダベースのノートシステムでも役立つ場合はありますが、標準のチェックは Obsidian 形式の内容に合わせてあるため、必要に応じて調整が必要です。

普通のプロンプトより優れていますか？

同じ監査を毎回再現したいなら、多くの場合はそうです。通常のプロンプトでもクリーンアップ案は出せますが、vault-cleanup-auditor には固定のスキャンパターン、必須入力の扱い、保存されるレポートがあるため、結果を再現しやすく、月ごとの比較もしやすくなります。

初心者は repo の構成を知る必要がありますか？

いいえ。ただし、初心者でも実行前に短い説明セクションは読んでおくべきです。重要なのは、vault-cleanup-auditor は vault path がないと開始しないこと、そしてチェックが正しいフォルダをたどれるよう、実在する vault root を指定する必要があることです。

どんなときに使わないほうがいいですか？

広い意味での編集リライト、コンテンツ戦略の助言、ノート品質に対する人間的な判断がほしい場合は、vault-cleanup-auditor を使わないでください。これは cleanup auditor であって writing assistant ではなく、「何が古いか、壊れているか、重複しているか、空か」を見極めたいときに最も価値があります。

vault-cleanup-auditor skill の改善方法

監査範囲をもっと明確にする

vault-cleanup-auditor の結果を改善するうえで最も効果が大きいのは、vault の境界をはっきり定義することです。vault に archives、同期済みバックアップ、templates、生成コンテンツが含まれるなら、それを明示してください。そうすることで、意図的に置いてあるものを clutter と誤認しにくくなります。

監査基準を調整する

デフォルトのチェックが緩すぎる、または厳しすぎる場合は、依頼文の中でルールの解釈を絞り込んでください。たとえば、「stale」を 30 日とみなすのか 90 日とみなすのか、template system 配下の空フォルダを無視するのか、重複ファイル名を 1 つの project 内だけで問題視するのか vault 全体で問題視するのかを指定します。

最初のレポートをよくする

最初の出力が最も役立つのは、vault path が正しく、ノートの運用ルールが一貫している場合です。結果がノイズっぽいと感じるなら、原因は入力の整え方にあることが多いです。見出しのないファイル、混在した draft 状態、意図的に重複させている名前などです。運用ルールを整えるか例外を説明してから、vault-cleanup-auditor guide をもう一度実行してください。

本当に重要な点から順に改善する

最初の実行後は、skill 自体を変える前に、優先度の高い指摘から確認します。多くのユーザーにとって最も重要なのは、古い下書きと重複ファイル名です。これらは維持管理の負担を最も大きくしやすいからです。もしレポートが重要な項目を見逃しているなら、より広い「もっと良い監査」を求めるのではなく、具体例を 1 つ追加して指示を更新してください。