Quickstart

Install

One command installs Lore into every supported agent on your machine (requires Node ≥ 22.5):

npx skills add specstoryai/getspecstory --skill lore

Installs are copies, so they stay put until you update them:

npx skills update lore

In Claude Code you can manage Lore through the plugin system instead:

/plugin marketplace add specstoryai/getspecstory
/plugin install lore@specstory

Plugin installs update via /plugin update lore.

Run it

Agent	Invoke with
Claude Code	`/lore`
Codex	`$lore`
Cursor	just ask, e.g. "mine my lore"
Gemini CLI	just ask; the model activates the skill with your consent

Press Enter on a bare /lore and it walks you through three quick questions - scope (this project or all your repos), time window, and goal - then mines, shows you evidence-backed dossiers of your candidate skills, and presents a forge plan to approve.

What a first run looks like

Mining - the engine indexes your .specstory/history transcripts into ~/.specstory/lore.db and reports what it found: projects, sessions, commands, and outcomes.
Candidates - your agent presents the workflows that recur with evidence: how often, across how many sessions, and whether they worked.
Dossiers - the strongest candidates get deep-mined into full dossiers: the canonical steps, variations, verification moves, and failure modes with recoveries.
The forge plan - you approve exactly what becomes a skill. Approved skills land in ~/.agents/skills/<name> and install across your agents.

Tip

Nothing leaves your machine. The corpus, the mining, and the forged skills are all local files - the engine makes no network calls and needs no API keys.