lint-brainlisted

# Lint Brain Vault health check skill. Scans the brain repo for structural issues - orphan notes, broken links, missing metadata, stale files, and poorly connected knowledge islands. Reports a scored summary and optionally fixes issues. ## Trigger phrases - `/lint-brain` - "lint the brain" - "vault health check" - "brain hygiene" - "check vault health" ## Vault location `~/brain/` ## Directories to check - `projects/` - project knowledge (one subdir per project, includes decisions) - `research/` - non-project research (ai-agents, infrastructure, compliance, business, content) - `knowledge/` - curated long-lived reference (lenny, people, companies) - `decisions/` - cross-cutting decision records - `docs/` - repo meta, templates, skill output ## Directories to skip - `meetings/` - read-only, managed by granola-sync. Never modify. - `sources/` - gitignored third-party material - `archive/` - inactive projects - `.obsidian/` - Obsidian config - `tmp/` - ephemeral files ## Step 0 — run the stats script FIRST (do not count by hand) ```bash python3 ~/brain/docs/scripts/lint/vault-stats.py --json ``` **Every countable metric comes from this script.** Orphans, broken links, missing frontmatter, staleness, near-duplicates, duplicate source URLs, thin-but-linked pages, knowledge islands, hubs, and existing contradiction flags are all computed deterministically in ~0.3s. Do **not** recount them yourself. On 2026-08-02 this skill's first persisted audit got five counts wrong