Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →bybren-llc/vault-sync
Detect and repair drift between an OKF knowledge vault and the code it describes. Use after merging significant changes (schema, interfaces, workflows, agent config), when a staleness review is due, or when the user asks to sync, refresh, or update the knowledge vault.
Passed 12 of 17 test cases with the skill, and 7 of 17 without it.
and 7 more in the full report
7 fixed8 passed either way6 still failing1 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 6 test cases the skill fixed. Same model, same prompt, with and without the skill.
When completing a vault sync cycle, which specific fields inside `<vault>/_meta/manifest.json` must be updated to mark the new sync baseline?
| Checked | Without skill | With skill |
|---|---|---|
| Updates baseline_sha in manifest.json | Missed | Passed |
| Updates generated timestamp in manifest.json | Passed | Passed |
The instructions your model reads when the skill loads.
📋 TEMPLATE: This skill uses
{{TICKET_PREFIX}}and{{MAIN_BRANCH}}as placeholders, and assumes a vault created fromknowledge-vault/templates/starter-bundle.
Keep an OKF knowledge vault honest as the code evolves. The vault is a map of the system; this skill detects drift between map and territory, regenerates only the affected concepts, and records the sync.
Invoke this skill when:
stale-concepts Base is the queue)| Path | Role |
|---|---|
<vault>/_meta/vault-config.json | Machine-readable constitution — types, tags, frontmatter contract |
<vault>/_meta/CONVENTIONS.md | The human-readable rules |
<vault>/_meta/manifest.json | ID registry, reverse index, and baseline_sha drift watermark |
<vault>/_meta/templates/ | Per-type skeletons |
<vault>/log.md | Dated changelog |
knowledge-vault/scripts/validate-vault.mjs | The gate |
Gemini CLI has no native vault tooling. Steps 1, 4 and 5 are shell commands you run directly; steps 2 and 3 are authoring work.
Read the baseline and diff it to HEAD across the watch-list — the source paths your concepts claim to describe. Configure this list for your project; the example below is illustrative.
test cases passed, vs 7 / 17 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.