pkb

Index local Markdown files and retrieve semantic search results with contextual information.

7|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/dlants/pkb --skill pkb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pkb
Source: https://github.com/dlants/pkb/tree/main
Command: npx skills add https://github.com/dlants/pkb --skill pkb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @anthropic-ai/bedrock-sdk, @anthropic-ai/sdk, @aws-sdk/client-bedrock-runtime, better-sqlite3, sqlite-vec, and includes scripts (resource) components.

What problem does it solve?

PKB provides a local semantic search for Markdown documents, reducing time spent finding information across notes and enabling knowledge reuse.

Core Features & Use Cases

  • Semantic search over a local Markdown corpus with automatic chunking and contextual retrieval.
  • Track, index, and search directories or individual files via a CLI.
  • Use cases include personal knowledge bases, project documentation, and AI agents that need access to your notes.

Quick Start

  • Track a directory: npx tsx <path-to-pkb-skill>/scripts/cli.ts <dbPath> track <path>
  • Sync all tracked sources: npx tsx <path-to-pkb-skill>/scripts/cli.ts <dbPath> sync
  • Search the knowledge base: npx tsx <path-to-pkb-skill>/scripts/cli.ts <dbPath> search "<query>" [topK]

Frequently Asked Questions about pkb

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

FAQPage Schema
How do I set up a local semantic search over my Markdown notes?

Local semantic search over Markdown notes requires chunking file content, generating embeddings via an embedding model, and storing them in a SQLite database with a vector extension to enable contextual retrieval.

Can I index individual Markdown files instead of full directories?

Yes, you can index individual Markdown files or entire directories. The CLI supports tracking specific file paths and syncing all tracked sources to build a searchable local knowledge base.

What dependencies are needed to run a local vector database for contextual retrieval?

Running a local vector database for contextual retrieval requires SQLite with the sqlite-vec extension for storage, better-sqlite3 for database access, and an embedding model to generate vector representations.

How does contextual retrieval work when searching a local knowledge base?

Contextual retrieval works by chunking Markdown content into smaller segments, embedding those chunks into a vector database, and querying the embeddings to find relevant results with their surrounding contextual information.

Is the sqlite-vec extension required for semantic search over Markdown documents?

Yes, the sqlite-vec extension is required. It provides the vector database functionality within SQLite needed to store and query the embeddings generated from your Markdown documents.

What is the best way to integrate a personal knowledge base with an AI agent?

The best way is to index your Markdown files into a local SQLite vector database, allowing AI agents to query the embedded chunks and retrieve relevant contextual information from your notes.