vault-cleanup-auditorlisted
Install: claude install-skill BrianRWagner/ai-marketing-claude-code-skills
# 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
echo "=== END CHECK 1 ==="
```
**Check 2 — Incomplete files (no headings, 5+ lines):**
```bash
VAULT="VAULT_PATH_HERE"
echo "=== CHECK 2: INCOMPLETE FILES ==="
find "$VAULT" -name "*.md" \
-not -path "*/.git/*" \
-not -path "*/.obsidian/*" \
-not -path "*/.open