---
name: vault-stats
description: Report how the owner's vault is growing — total note count, word/character volume, size on disk, a per-area breakdown, and what's been added recently (new notes this week / since the last run, and the fastest-growing areas). Wraps the engine's `vault_stats` module (installed `alexandria-vault` package). Use when the owner says "vault stats", "how big is the vault", "how much has the vault grown", "how many notes do I have", "vault growth", "which areas are growing", or wants a size/growth read on the vault. Read-only against the vault; it persists a small daily history so run-over-run trends survive. NOT the digest/todo content, and NOT a git-history audit.
---

# vault-stats — folder-root adapter

The real playbook lives in the brain: **`Agent/skills/vault-stats.md`** (this folder
is the vault root). Read that file and follow it exactly as written, using the
shipped CLI at `.alexandria/app/.venv/bin/alexandria` wherever it says
`alexandria`, and `.alexandria/app/.venv/bin/python` for
`python -m alexandria_vault.…` entrypoints.

If `Agent/config.json` does not exist, nothing is installed yet — stop and
follow `./CLAUDE.md` (the installer) instead of this skill.
