vault-cleanup-auditor

npx skills add majiayu000/claude-skill-registry --skill vault-cleanup-auditor --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Vault Cleanup Auditor Runs 4 targeted checks against your Obsidian vault and saves a prioritized audit report to `vault-audit/YYYY-MM-DD-audit.md`. Takes under 30 seconds. No APIs, no paid services. Run it monthly or whenever the vault starts feeling messy. --- ## How to Use Open Claude Code and say: ``` Run the Vault Cleanup Auditor skill against my vault at /path/to/vault. ``` --- ## Skill Instructions (for Claude Code) When this skill is invoked, follow these phases exactly. --- ### PHASE 1: INTAKE Check whether the user has provided: - `vault_path` — absolute path to their Obsidian vault root **If missing, ask:** ``` What's the absolute path to your Obsidian vault? (e.g. /root/obsidian-vault) ``` Do not proceed until confirmed. --- ### PHASE 2: ANALYZE Run all 4 checks. Capture raw output from each before writing the report. **Check 1 — Stale drafts (30+ days, unposted):** ```bash VAULT="VAULT_PATH_HERE" echo "=== CHECK 1: STALE DRAFTS ===" find "$VAULT/content/ready-to-post" -name "*.md" -mtime +30 2>/dev/null | while read f; do if grep -q '\*\*Posted:\*\* ❌' "$f" 2>/dev/null; then days=$(( ($(date +%s) - $(stat -c %Y "$f")) / 86400 )) echo "${days}d|${f##$VAULT/}" fi done e

echo "=== CHECK 1: STALE DRAFTS ==="
find "$VAULT/content/ready-to-post" -name "*.md" -mtime +30 2>/dev/null | while read f; do
if grep -q '\*\*Posted:\*\* ❌' "$f" 2>/dev/null; then
echo "${days}d|${f##$VAULT/}"
fi
done
echo "=== END CHECK 1 ==="
echo "=== CHECK 2: INCOMPLETE FILES ==="
find "$VAULT" -name "*.md" \
if ! grep -qE '^#{1,6} ' "$f" 2>/dev/null; then