/memory Skill
Manages the per-project knowledge store. Most subcommands are script calls — run and show the output.
Route $ARGUMENTS
Match the first word of $ARGUMENTS to a command below. If empty, show the index.
Resolve knowledge path first:
KDIR=$(lore resolve)
add <category> <title>
Quick-add directly to a category directory (bypasses inbox):
- Write entry as
$KDIR/<category>/<slug>.mdwith# Title, body, and<!-- learned: ... | confidence: high | source: manual -->metadata - If category directory doesn't exist, create it
- Run
lore heal
search <query>
lore search "<query>" --type knowledge
Show the script output. For top matches, briefly summarize relevant context.
view [category] [query]
- No argument: run
lore indexand display the dynamic category/entry listing - With category:
lore read <category>(resolves knowledge, domains/, and _threads/ files) - With category + query:
lore read <category> --query "<query>"(matching sections full, non-matching as heading-only) view inbox: read.mdfiles from$KDIR/_inbox/- For threads:
lore read <slug> --type threadorlore read <slug> --type thread --query "<query>"
curate
Periodic refinement of the knowledge store (optional, not required).
Start with the mechanical pre-scan:
lore curate
This lists inbox remnants, medium-confidence entries, and entries missing backlinks. Then apply judgment:
- Refile inbox remnants: If
$KDIR/_inbox/has.mdfiles (from interrupted captures), review each and either file to the correct category or drop. - Quality gate for medium-confidence entries: Scan entry files for
confidence: mediumin their HTML comment metadata (typically from agent captures). Re-evaluate each against the 4-condition gate:- Reusable beyond the original task?
- Non-obvious — not already covered by another entry or docs?
- Stable — still accurate?
- High confidence — can you verify it now?
Drop entries that fail the gate. Upgrade passing entries to
confidence: high.
- Deduplicate: Merge entries that describe the same insight from different contexts.
- Backlinks: Add missing
[[backlinks]]cross-references between related entries. - Title quality: Improve vague or generic titles to be specific and scannable.
- Stale entries: Flag or remove entries that contradict current code.
- Confidence calibration: If
$KDIR/_capture_log.csvexists, count entries withsource=stop-hook. Compare against the number of stop-hook medium-confidence entries that passed the quality gate (upgraded) vs failed (dropped). Report the pass rate:>70%pass rate: "Stop hook evaluator is well-calibrated"40-70%pass rate: "Stop hook evaluator calibration is acceptable"<40%pass rate: "Stop hook evaluator needs tightening — consider refining triggers in scripts/stop-capture-prompt.txt"
- Report what was found and fixed:
[curate] Done. Dropped: N entries (reasons) Merged: N duplicates Upgraded: N to high confidence Backlinks added: N Stop hook calibration: X/Y passed (Z%) — <assessment> - Run
lore heal
Drop authority: Curate has explicit authority to remove entries without user confirmation when they fail the 4-condition gate. Report what was dropped in the summary so the user can object.
renormalize
Redirect to /renormalize skill. Invoke /renormalize instead.
heal
lore heal
Show the script output. To apply fixes: lore heal --fix
init [--force]
- Check if inside a git repo:
git rev-parse --is-inside-work-tree - If yes:
lore init - If no: inform user, ask for confirmation, then
lore init --force - Report the created path
Converted and distributed by TomeVault — claim your Tome and manage your conversions.