# Skill: content-audit

- **Name:** Content Audit, the Librarian Pass
- **Trigger:** "audit my content" · monthly, alternating with system-audit
- **Requires:** file access to the whole vault · nothing external · Level: Minimum
- **Output:** For every folder: does it have exactly one index file, and does the index list what actually exists? Constitution measured in tokens against budget. All 5 layers checked for presence and leakage. A merge/archive/rewrite list, proposed only.
- **Safety:** READ ONLY. It proposes changes as a list and changes nothing. You approve items one by one, or not at all.

## Before you run it

Same rule as system-audit: strongest model, maximum thinking, parallel
agents if available. It has to actually read your folders, not sample
them. Expect 30 to 50 minutes on a real vault.

## Steps

1. INDEXES. Walk every folder that holds more than a handful of files.
   Each must have exactly one index file. Flag: folders with none,
   folders with two, and orphan files that exist on disk but appear in
   no index. An unlisted file is invisible to the AI, that is the bug.
2. CONSTITUTION. Measure every always-loaded file in tokens. Compare
   against the budget written inside the constitution itself. Flag
   anything stale: dates in the past, projects that ended, statements
   that a newer file contradicts.
3. FIVE LAYERS. Constitution, memory, skills, tools, focus: is each
   present, findable within two clicks from the root, and current?
   Flag leakage: memory content sitting in the constitution, project
   detail sitting in the focus file, skill instructions duplicated
   outside the skills folder.
4. FOCUS. Does the focus file match reality? Dead dates, finished
   projects still listed, new work happening that it never mentions.
5. Report per folder, shortest possible: OK, or the finding in one line.
   Finish with one list: MERGE / ARCHIVE / REWRITE, each item one line
   with the reason. Change nothing yet.

## Example run

Me: audit my content

AI (after ~35 minutes):
INDEXES: 12 folders checked. projects/ index missing 2 files added last
week (invisible). clients/ has TWO index files, the older one stale.
health/ has no index at all, 9 files.
CONSTITUTION: 11.2k tokens, budget says 12k, within. The focus file
still names the April launch as "next week".
LAYERS: all 5 present. Leakage: 3 skill definitions live inside the
constitution instead of the skills folder.
FOCUS: 2 dead dates, 1 finished project still listed as active.
MERGE: clients/ two indexes into one.
ARCHIVE: April launch folder; finished project from focus.
REWRITE: health/ needs an index (I can draft it); move 3 skills out of
the constitution.

Me: do the merge and draft the health index, show me before saving.

## Make it yours

- Pair it: system-audit checks the machinery, content-audit checks the
  writing. Alternate them, one audit every two weeks covers both monthly.
- Add a naming pass to step 1 if your files drift: flag names that break
  your own convention.
- Tighten step 2 by writing the token budget INTO your constitution if
  it is not there yet; the audit then has a number to hold you to.