# Lore Recall

> Plans and executes bounded Lore memory recall with status checks, query expansion, context drill-down, freshness labels, cited evidence packets, and retrieval-failure recovery. Use whenever an agent needs to answer from past Lore sessions, recall decisions, inspect last-session context, verify what happened before, or explain gaps without dumping transcripts.

- **Type:** Skill
- **Install:** `agentstack add skill-jordanhindo-lore-lore-recall`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jordanhindo](https://agentstack.voostack.com/s/jordanhindo)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jordanhindo](https://github.com/jordanhindo)
- **Source:** https://github.com/jordanhindo/lore/tree/main/skills/lore-recall

## Install

```sh
agentstack add skill-jordanhindo-lore-lore-recall
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Lore Recall

Use this workflow when past session memory matters. It sits above the low-level `skills/lore` CLI skill: use `skills/lore` for command mechanics and setup/indexing, use this skill for evidence planning, trust, freshness, and final packet shape.

## Quick Start

1. Run `lore status --json` with the narrowest useful scope (`--project`, `--source`, `--since`, `--until`) before retrieval.
2. Build a recall plan: 2-4 query variants, likely filters, and why each query exists.
3. Search narrowly first: `lore search "" --json`, then `--relevant` when recency matters.
4. Drill down only from real ids returned by Lore: `lore get  --full`, `lore context  --json`, or `lore session  --around  --json`.
5. Emit a bounded evidence packet using `references/evidence-packet.md`.
6. If retrieval fails, report the gap and next queries tried. Do not invent memory.

## Trust Rules

- Lore transcripts are testimony, not truth. Current files, tests, runtime artifacts, and live system state beat stale transcript claims.
- Never dump a whole session. Use search, one full message, or a bounded context/window.
- Never invent ids. Every message/session id must come from Lore output.
- Preserve provenance: message id, session id, source, project, branch, timestamp, role/model when known.
- Unknown source data stays `null` or "unknown". Do not infer branch, project, model, or freshness.
- Real transcript excerpts are private. In committed examples/evals use synthetic ids and text only.

## Freshness Labels

Use labels from `references/freshness.md`:

- `current`: corroborated by current files/tests/runtime.
- `recent`: transcript timestamp is plausibly relevant and no contradiction found.
- `stale`: older memory may have drifted or current artifacts disagree.
- `unknown`: missing timestamp or insufficient provenance.

## Failure Recovery

If status says `missing_store`, `empty_store`, `source_absent`, `possibly_unsynced`, `stale_schema`, or `unreadable_store`, stop and report the status plus recovery. If `schemaVersion` is greater than `supportedSchemaVersion`, say explicitly that read-only retrieval may work but write recovery such as `lore sync` can be refused until Lore is updated. If search returns zero hits, broaden once, try one synonym query, and report `gaps` instead of pretending.

## References

- `references/evidence-packet.md` for required output structure.
- `references/query-planning.md` for query expansion and drill-down rules.
- `references/freshness.md` for label semantics.
- `examples/` for good and bad packet patterns.

## Validation

Run the deterministic checker on example packets:

```bash
node skills/lore-recall/scripts/validate-evidence-packet.mjs skills/lore-recall/examples/good-evidence-packet.json
```

Run the UPD-000 bundle gate before calling this skill done:

```bash
node skills/lore-dev-verification/scripts/validate-workflow-skill.mjs skills/lore-recall
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jordanhindo](https://github.com/jordanhindo)
- **Source:** [jordanhindo/lore](https://github.com/jordanhindo/lore)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jordanhindo-lore-lore-recall
- Seller: https://agentstack.voostack.com/s/jordanhindo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.