corpus-search

Search markdown corpora using BM25 and vector embeddings with optional reranking.

3|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Motion-Creative/runneth-apps --skill corpus-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: corpus-search
Source: https://github.com/Motion-Creative/runneth-apps/tree/main/corpus-search
Command: npx skills add https://github.com/Motion-Creative/runneth-apps --skill corpus-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You need reliable ways to find relevant information inside large collections of markdown notes, transcripts, and summaries without manually reading everything.

Core Features & Use Cases

  • Hybrid retrieval over your corpus: combines keyword matching and semantic search to return ranked, relevant chunks.
  • Local, sandbox-only index: builds a persistent SQLite store (including FTS for BM25 and vector search for embeddings) with no separate server to run.
  • Useful metadata for real workflows: supports role filtering and timestamp extraction from markdown so results can be traced back to where they occurred.

Quick Start

Ask to install and index your markdown sources, then immediately run a natural-language query against the indexed kind to get ranked results back in under a second.

Frequently Asked Questions about corpus-search

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

FAQPage Schema
How do I search markdown transcripts and notes by meaning instead of exact keywords?

Markdown semantic search combines vector embeddings with BM25 keyword matching to find relevant passages by meaning rather than exact terms. This hybrid retrieval ranks chunks from your corpus based on conceptual similarity to your query intent.

Can I filter markdown search results by metadata like role, kind, or date ranges?

Markdown search supports filtering by kind, role, workspace, and date ranges by ingesting YAML frontmatter metadata. You can narrow ranked retrieval results to specific document types or contextual attributes within your corpus.

How do I build a local search index for a folder of markdown files?

Building a local markdown search index uses a sandbox-only SQLite store with FTS5 and sqlite-vec for BM25 and vector search. Indexing is idempotent, persistently storing corpus metadata and embeddings without requiring a separate server to run.

What is the best way to search video scene summaries with timestamps in markdown?

Searching markdown video scene summaries uses hybrid retrieval with timestamp extraction to trace results back to where they occurred. Querying natural-language intent against indexed summaries returns ranked passages with timestamps in under a second.

Does hybrid retrieval over markdown corpora require an external database server?

No, hybrid retrieval over markdown operates entirely within a workspace sandbox using a local SQLite database. It combines FTS5 for BM25 keyword matching and sqlite-vec for vector embeddings, requiring no separate server setup or external infrastructure.

Why does my markdown keyword search miss relevant transcripts that use different wording?

Keyword search alone misses relevant transcripts because it relies on exact term matching. Hybrid retrieval solves this by adding vector embeddings to capture semantic meaning, ensuring passages with different wording but similar intent are still returned and ranked.