This runs four targeted checks on your Obsidian vault and drops a dated markdown report in a vault-audit folder. It finds drafts older than 30 days that haven't been posted, files with no headings but enough content to matter, duplicate filenames across folders, and empty directories. The whole thing runs in under 30 seconds using bash and standard Unix tools. No APIs, no paid services, just file system traversal. It's the kind of thing you'd run monthly when your vault starts feeling cluttered and you need a concrete list of what to clean up rather than just a vague sense that things are messy. The self-critique phase at the end ensures all four checks actually ran and the counts match.

skills.sh installs
373
GitHub stars
455
last updated
Aug 21, 2026

Install

$ npx -y skills add brianrwagner/ai-marketing-claude-code-skills --skill vault-cleanup-auditor --agent claude-code

Installs into .claude/skills of the current project.

Files

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):

Sponsors

Details

Repository
github.com/brianrwagner/ai-marketing-claude-code-skills
Categories
AI & Agent Building, Marketing & SEO, Office & Documents
First seen
Jun 3, 2026

More from brianrwagner/ai-marketing-claude-code-skills

All 23
1jwynia avatarclaim-investigationjwynia/agent-skillsSystematically investigate social media claims and viral content. Use when fact-checking complex claims, when decomposing multi-part assertions, or when investi370skills.sh installs
2thedivergentai avatargodot-particlesthedivergentai/gd-agentic-skillsExpert blueprint for GPU particle systems (explosions, magic effects, weather, trails) using GPUParticles2D/3D, ParticleProcessMaterial, gradients, sub-emitters370skills.sh installs
3jwynia avataragile-workflowjwynia/agent-skillsOrchestrate agile development workflows by invoking commands in sequence with checkpoint-based flow control. This skill should be used when the user asks to 'ru369skills.sh installs
4sanjay3290 avatarazure-devopssanjay3290/ai-skillsManage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, a369skills.sh installs
5ancoleman avatarimplementing-drag-dropancoleman/ai-design-componentsImplements drag-and-drop and sortable interfaces with React/TypeScript including kanban boards, sortable lists, file uploads, and reorderable grids. Use when bu368skills.sh installs
6automattic avatarwp-phpstanautomattic/agent-skillswp phpstan368skills.sh installs