kb-retrieve-events

Query knowledge-base event files and rank matches by recurrence and recency.

1|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/williamthorsen/codeassembly --skill kb-retrieve-events-williamthorsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-retrieve-events
Source: https://github.com/williamthorsen/codeassembly/tree/main/packages/agents/content/skills/kb-retrieve-events
Command: npx skills add https://github.com/williamthorsen/codeassembly --skill kb-retrieve-events-williamthorsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding past observations scattered across knowledge-base event files is slow and error-prone; this Skill searches registered knowledge bases with ripgrep and returns a ranked list of relevant events so recurring problems and their history surface quickly. ## Core Features & Use Cases - Scoped event recall: Searches the discovered .kb/ store plus the registry default, with flags to widen to all knowledge bases (--all-kbs) or narrow to one (--store). - Filtering and ranking: Filters by tag and minimum impact level, then ranks candidates by genuine relevance, recurrence count, and recency. - Addressed-problem annotation: Surfaces addressedBy references so recurring-but-handled problems read as addressed rather than unresolved. - Use Case: When debugging a flaky timer issue, run the helper with the query and --min-impact high to find the most consequential past events, see how often the pattern recurred in the repo, and check what was already done about it. ## Quick Start Ask the agent to search the knowledge base for events about your problem, for example: "Find knowledge-base events about flaky timer failures ranked by recurrence."

Frequently Asked Questions about kb-retrieve-events

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search a knowledge base for past events?

Run the bundled helper with node, passing a free-text query: node kb-retrieve-events.mjs "your query". It resolves which knowledge bases to search, runs ripgrep over event files, and prints a JSON candidate list you rank by relevance, recurrence, and recency.

What is the difference between kb-retrieve and kb-retrieve-events?

kb-retrieve-events returns only events, the raw observations captured over time, ranked by recurrence and recency. For assertion recall of the canonical knowledge-base notes, use kb-retrieve instead.

How do I filter knowledge-base events by tag or impact?

Pass --tag to keep only events carrying that tag (canonical or alias form, case-insensitive), or --min-impact with low, medium, high, or critical to drop events rated below the floor. Unrated events are excluded when an impact floor is set.

What runtime dependencies does the event recall helper need?

The helper requires Node.js version 24 or later and ripgrep (rg) installed on the system. If ripgrep is missing, the helper exits with a remediation hint explaining how to install it.

Why does my knowledge-base event search return no results?

The helper's diagnostic field explains empty results: no knowledge base configured, an unregistered --store name, no notes matching the query, or filters excluding all matches. Broaden the query, add --all-kbs, or loosen the filters.