Install any skill in seconds. Free to start, no credit card required.
Get Started Free →hashgraph-online/vault-mirror
Use when you need to populate the Meta-Vault with machine-generated notes derived from session-orchestrator JSONL records. Converts entries from `.orchestrator/metrics/sessions.jsonl` and `.orchestrator/metrics/learnings.jsonl` into vault-conformant Markdown under `50-sessions/` and `40-learnings/`. Called automatically at session-end Phase 3.7 and after evolve Phase 3.5 — only when `vault-integration.enabled=true` and `vault-integration.mode != "off"`. Idempotent: re-runs safely; skips hand-aut
Passed 16 of 19 test cases with the skill, and 5 of 19 without it.
and 13 more in the full report
12 fixed6 passed either way4 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 12 test cases the skill fixed. Same model, same prompt, with and without the skill.
The mirror tool attempts to write a session note, but a file already exists at the target path and it does not contain the `_generator` marker in its frontmatter. What action is emitted and what happens to the file?
| Checked | Without skill | With skill |
|---|---|---|
| States the action emitted is skipped-handwritten | Missed | Passed |
The instructions your model reads when the skill loads.
Project-instruction file resolution:
CLAUDE.mdandAGENTS.md(Codex CLI) are transparent aliases — see skills/_shared/instruction-file-resolution.md. When this skill mentions Session Config inCLAUDE.md, the alias rule applies.
vault-mirror populates the Meta-Vault with machine-generated notes derived from structured JSONL records. It converts entries from .orchestrator/metrics/sessions.jsonl and .orchestrator/metrics/learnings.jsonl into vault-conformant Markdown files under numeric-prefix subdirectories. This is distinct from vault-sync, which validates the vault — vault-sync validates the vault; vault-mirror populates it. The two skills are complementary: vault-mirror writes notes, vault-sync checks that the vault as a whole remains conformant.
vault-mirror is called in two places:
skills/session-end/session-metrics-write.md) — mirrors the sessions.jsonl entry for the closing session.skills/evolve/SKILL.md) — mirrors all learnings.jsonl entries added during the evolve cycle.Both call sites are conditional: vault-mirror runs only when vault-integration.enabled == true AND vault-integration.mode != "off" in the project's Session Config. When either condition is not met, the call site skips silently and vault-mirror is never invoked.
scripts/vault-mirror.mjs is the implementation. All arguments are required except --dry-run.
| Flag | Type | Required | Description |
|---|---|---|---|
--vault-dir | path | yes | Absolute path to the Meta-Vault root directory. Must exist. |
--source | path | yes | Path to the JSONL file to read (one JSON object per line). Must exist. |
--kind | session or learning | yes | Determines which generator and target path are used. |
--dry-run | flag | no | Parse and resolve paths but do not write any files. Emits action lines as normal. |
Empty lines in the JSONL source are silently skipped.
One JSON line is written to stdout for each non-empty JSONL entry processed. Exit code reflects the run outcome.
action | Meaning |
|---|---|
created | Entry did not exist in the vault; file created. |
updated | Entry existed (generator marker present, same id) with an older updated date; file overwritten. |
test cases passed, vs 5 / 19 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.