kb-search

Search knowledge base and local notes with keyword expansion and heading ranking.

2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/tim-hub/powerball --skill kb-search-tim-hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-search
Source: https://github.com/tim-hub/powerball/tree/main/personal/skills/kb-search
Command: npx skills add https://github.com/tim-hub/powerball --skill kb-search-tim-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, ripgrep, and includes scripts (resource) components.

What problem does it solve?

Quickly retrieve relevant information from your knowledge base and local notes, reducing time spent hunting for context.

Core Features & Use Cases

  • Keyword search across the knowledge base and local files to surface relevant passages.
  • Contextual ranking returns top results with headings and snippets for fast comprehension.
  • Use Case: When answering a question, pull past notes and KB articles to assemble a well-supported response.

Quick Start

Search for a topic by keyword to retrieve the most relevant notes and KB results.

Frequently Asked Questions about kb-search

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

FAQPage Schema
How do I search my local knowledge base and notes for relevant information?

You can search your knowledge base by submitting keywords, which triggers parallel variant searches, deduplication, and heading relevance ranking to deliver top snippets. This surfaces relevant passages from local files for fast comprehension.

How does knowledge base search rank results for better context?

Knowledge base search ranks results by heading relevance to provide contextual snippets. It performs keyword expansion and parallel variant searches, deduplicating matches to ensure the top results offer the most pertinent context.

Do I need ripgrep and jq installed to search my notes?

Yes, you need ripgrep and jq installed to execute the search scripts. The Skill relies on these dependencies to perform fast, safe searches across your configured knowledge base and local notes.

What is the best way to configure a knowledge base for local file searches?

The best way to configure a knowledge base is by setting up a config file at ~/.kb/config.json. This configuration allows the search scripts to locate and query your notes accurately.

Can I use keyword search to pull past notes and KB articles for answering questions?

Yes, you can use keyword search to pull past notes and KB articles. It retrieves relevant passages with headings and snippets, allowing you to assemble well-supported responses quickly.