Agent skill · wshobson
grounded-vault
Use when maintaining a durable Markdown knowledge store that agents compile from sources, when every number or quote in a wiki page must trace back to an immutable source, or when compiled pages need cheap drift detection against the code they describe. Teaches the raw/wiki/archive layout, per-claim provenance links, and git fingerprints for zero-token staleness checks.
What it needs
About 3k tokens when loaded.
What this skill does
Grounded Vault A grounded vault is a three-layer Markdown store in which every compiled claim can be traced back to an immutable source and every page can be checked for staleness with one git diff. It needs a git repository and nothing else. The convention comes from the llm-wiki-loop project, which is a reference implementation rather than a dependency; this skill teaches the pattern so it works with plain files and whatever agent is in the session. When to Use An agent compiles notes, papers, transcripts, logs, or code into wiki pages that later sessions rely on. A page cites numbers, dates, or quotes, and a reader must be able to verify each one against its source. Pages describe code, and rereading the codebase every session to check whether they still hold is too expensive. Knowledge must be corrected without losing history: superseded pages are archived, never deleted. Session state, task queues, and conversation continuity are a different problem; use the context-management or conductor plugins for those. This skill is about provenance and drift on a durable knowledge store. The three layers Layer Contents Who writes it Rule --- --- --- --- raw/ source material: notes, papers, transcripts, logs, exported data people and ingestion only immutable once added; agents never edit a raw file wiki/ compiled pages built from raw/ and from code agents and people every number, date, and quote links to its source archive/ pages that drifted or were superseded agents, during garbage collection moved, never deleted; the header says why Two files sit at the vault root. index.md is the map of every current page. log.md is an append-only record of what changed and why. Both change in the same commit as the page they describe. Page header contract Every wiki/ page opens with a header block: Raw: lists every source the page was compiled from. Inline claims link to their specific source as well: Tokens expire after 15 minutes (raw/adr/0007-jwt.md). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills wshobson/grounded-vault