vault-audit
Skill6 starsChanged 47 days agoMITView on GitHub
The vault's health check — self-test, build and audit.js — reported in a few lines: problems, watch items and query cost against the 30–50× target, then which to fix. Cheap: the tools' output stays in a file, not the conversation. For the expensive checks (anything answerable only from raw/, a gap audit by agents) use /vault-deep-audit. Explicit only: start it when the owner invokes it by name, never on your own.
7 other projects use a version of this.
Adopted by
Most recently taken up by
- xpoes123/claude-skillstheir own version, first seen Oct 20, 2026
- Arthurmf01/claude-skillstheir own version, first seen Oct 20, 2026
- kriscard/Skillstheir own version, first seen Oct 13, 2026
- gnekt/My-Brain-Is-Full-Crewtheir own version, first seen Oct 8, 2026
- NovaKepler513/claude-skillstheir own version, first seen Jul 2, 2026
- YiweiCreates/claude-skillstheir own version, first seen Jul 2, 2026
Other versions7 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 7
- gnekt/My-Brain-Is-Full-Crew★ 3.9ksame name
- pass-agent/loomkin★ 179same name
- kriscard/Skills★ 15same name
- Arthurmf01/claude-skills★ 0same name
- NovaKepler513/claude-skills★ 0same name
- xpoes123/claude-skills★ 0same name
- YiweiCreates/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- vault-compileSkill
- vault-deep-auditSkill
- vault-excalidrawSkill
- vault-handoffSkill
- vault-tailorSkill
- vault-auditSkill
- vault-compileSkill
- vault-deep-auditSkill
- vault-excalidrawSkill
- vault-handoffSkill
- vault-tailorSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 5 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
If a list runs long, grep the file for that one check instead of printing more.
- Distinctive: line 55
No problems and no watch items: say so in one line and skip the question.
- Distinctive: line 56
Always say where the full output is.
- Distinctive: line 60
Every fix follows AGENTS.md § Defect Discipline: fix the instance, find the root cause, prevent the class, ledger it.
“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
<!-- Generated from .claude/skills/vault-audit/SKILL.md by node tools/agents-sync.js — edit that file, not this one. -->Audit the vault
The owner typed /vault-audit, so running the audit is authorised for this run
(AGENTS.md § Compile and Audit, D78). Keep it cheap: the tools' output goes
into a file, and only the summary enters the conversation.
1. Run the tools
OUT="$(node -p "require('os').tmpdir()")/vault-audit-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$OUT"
node tools/selftest.js > "$OUT/selftest.txt" 2>&1; echo "selftest exit $?"
node tools/build-index.js > "$OUT/build.txt" 2>&1; echo "build exit $?"
node tools/audit.js > "$OUT/audit.txt" 2>&1; echo "audit exit $?"Order matters: the build regenerates the index files the audit reads.
2. Read only what the report needs
tail -2 "$OUT/selftest.txt"
sed -n '/^\(WARNINGS\|PROBLEMS\)/,$p' "$OUT/build.txt"
grep "cheaper than loading sources" "$OUT/audit.txt"
sed -n '/^VERDICT/,$p' "$OUT/audit.txt"If a list runs long, grep the file for that one check instead of printing more.
3. Report
Always this shape:
Vault audit — YYYY-MM-DD
Self-test N/N · build clean (or N problems) · audit N problems, N watch items
Query cost: median N× (A–B×), target 30–50×
Problems
1. <what is wrong, in plain words> (Dnn) — <count>: <up to 5 items, then "+N more">
Watch
- <one line each; say which look like real defects>
Which should I fix — numbers, "all", or "none"?No problems and no watch items: say so in one line and skip the question. Always say where the full output is.
4. Fix what they pick
Every fix follows AGENTS.md § Defect Discipline: fix the instance, find the
root cause, prevent the class, ledger it. Rebuild after content fixes; run the
self-test after tooling fixes. To confirm the fixes, re-run the three commands
into the same folder and report the one-line verdict.
What the tools cover
audit.js covers: index consistency both directions · the alias probe against
tools/probes.json, plus must-route terms that have to reach a specific
node and US-spelling probes that must genuinely test spelling · graph shape
(orphans, dead ends) · counts by kind and topic · answer-surface distribution ·
frontmatter drift · query cost — it replays the benchmark queries through
the L0→L1 protocol and reports the ratio against the fixed source baseline, so
the prime directive is measured on every audit rather than asserted ·
code identifiers only a log names, or named widely with no alias · compiled
documents with no verbatim node · captures waiting in raw/ · tag facets named
like a probe term · open statuses gone stale ·
gendered pronouns that were never stated · media · drawing transcriptions older
than their drawing, drawings no note embeds, and embedded drawings whose
layout lints with errors (D75). The builder, for its part, also
fails corrected claims creeping back and fences whose own examples fail,
[sic] notes that pick a side, people named without a link, drifted Obsidian
settings (and warns on folders without an icon), faceted-tag drift, secrets in
plugin settings, rewritten log entries and verbatim text, notes outside the
indexed folders, code blocks that pull their code from another file, drawing embeds that are missing,
unreadable or carry no drawing-hash, and claims attributed to NotebookLM
outside a log or a verbatim node. Routing probes use a literal, line-based
grep -i — exactly the L0 query — so a term only a forgiving matcher could
find does not pass. It exits non-zero on any problem.
Not this skill
The checks the tools cannot make — whether anything is answerable only from
raw/, judgement on each watch item, a gap audit, the scope of any coverage
claim — are /vault-deep-audit's.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

