What problem does it solve? Searching scattered Markdown knowledge-base notes by hand is slow and error-prone, and raw grep hits do not tell you which notes are current, deprecated, or genuinely relevant. This Skill runs a bundled recall helper over registered knowledge bases and guides the ranking of candidates so you get a trustworthy, annotated answer list. ## Core Features & Use Cases - Scoped recall across knowledge bases: Searches the project-local .kb/ store plus the registry default by default, with flags to widen to all registered KBs or narrow to one named store. - Facet filtering: Restricts results by Diátaxis type (howto, concept, reference), tag, or folder segment. - Freshness and supersession annotations: Flags stale notes (not verified in 90+ days), volatile tags, deprecated notes with canonical successors, and problems that have recorded resolutions. - Registry health reporting: Surfaces malformed registries and dead KB paths as warnings instead of silently shrinking the search. - Use Case: While working in a monorepo, ask how the team handles pnpm workspace setup; the Skill searches the knowledge bases, ranks matching how-to notes, and points you to the current canonical guidance rather than a superseded draft. ## Quick Start Ask the agent to search the knowledge base for a topic, for example: "Use kb-retrieve to find notes about pnpm workspace setup, filtered to how-to guides."
