Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →specstoryai/lore
SpecStory Lore - mine your SpecStory coding histories (any agent - Claude Code, Codex, Cursor, Gemini, and more) into a persistent corpus, surface your reproducible workflows with corroborated evidence, and interactively forge the chosen ones into skills installed across all your agent harnesses.
Passed 11 of 20 test cases with the skill, and 3 of 20 without it.
and 7 more in the full report
9 fixed3 passed either way10 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.
After writing a new SKILL.md file for a candidate named 'deploy-staging', what registry command must be called to snapshot its evidence state and track future drift?
| Checked | Without skill | With skill |
|---|---|---|
| Calls mine-skills.mjs forged add with --name deploy-staging and the file path | Missed | Passed |
The instructions your model reads when the skill loads.
Your sessions are your lore. This skill turns a user's real coding history into installed skills.
A deterministic engine (scripts/mine-skills.mjs) parses their SpecStory transcripts - from every
agent SpecStory captures (Claude Code, Codex CLI, Cursor CLI, Gemini CLI, Factory Droid, DeepSeek,
Antigravity, ...) - into a persistent corpus of beats, and returns corroborated candidates.
You - the calling agent, whichever harness you are - supply all judgment: name them, discard the
generic ones, and interactively forge the good ones into SKILL.md packages grounded in the user's
own commands.
The engine does the retrieval and counting; you do the synthesis. Do not try to read raw transcripts yourself - they can be hundreds of thousands of lines. Run the engine and work from its output.
This skill is harness-portable (agentskills.io format). Where it names a specific tool
(e.g. AskUserQuestion), treat that as "use your harness's equivalent; fall back to plain chat."
Voice: when narrating to the user, talk about mining their lore and skill candidates - e.g. "I'll mine your lore here in for skill candidates." Reserve the word forge for the final act only: creating the skills the user selected (Step 4). Never describe mining, judging, or candidates as "forge-…" anything.
Named failure mode #1 (2026-06-09, BearClaude run): the agent indexed, deep-mined four skills, then jumped straight to AskUserQuestion with bare option labels - ZERO dossiers rendered in chat. The user declined every question because they had nothing to judge by. The entire mining run was wasted.
Named failure mode #2 (2026-06-09, BearClaude run, SAME DAY, fresh session, LAWs in effect): the agent narrated phases correctly, did verification reads, then asked again with NO dossier message - its last message before the question was process narration ("CodeMirrorBundle is alive in today's repo…") - and the question text falsely claimed "dossiers above". Lesson: a felt self-check is not a check. Compliance must be MECHANICAL: the sentinel line below is the check, not your impression.
Named failure mode #3 (2026-06-10, teammate's machine, Opus 4.8, plan-mode path): the agent DID
use plan-mode curation but presented a THIN plan - skill names and skip reasons with the dossiers
summarized away - so the user approved a forge they never saw the evidence for. The plan UI makes
skipping the display step impossible, not skipping the content. Lesson: the plan body must BE
the engine's plan render artifact (Step 3), which embeds every card verbatim and ends with the
LAW 1 sentinel. In Claude Code this is now HOOK-ENFORCED: a PreToolUse hook in this skill's
test cases passed, vs 3 / 20 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.