bookstrap-query

Translate natural language questions into SurrealDB queries for semantic search and graph traversal.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/mikkelkrogsholm/bookstrap --skill bookstrap-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bookstrap-query
Source: https://github.com/mikkelkrogsholm/bookstrap/tree/main/.claude/skills/bookstrap-query
Command: npx skills add https://github.com/mikkelkrogsholm/bookstrap --skill bookstrap-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables ad-hoc exploration of a knowledge base by translating natural language questions into precise SurrealDB queries, reducing manual querying and verification time.

Core Features & Use Cases

  • Natural language to queries: Convert user questions into semantic search, graph traversal, and timeline queries to retrieve relevant sections, characters, events, and sources.
  • Answer verification & source tracing: Surface supporting sources and citations to verify claims and trace knowledge back to origins.
  • Interactive exploration: Supports iterative refinement and hybrid queries that combine multiple query types for deeper insights.

Quick Start

Instruct the AI to translate a user question into a SurrealDB query and return structured results with sources.

Frequently Asked Questions about bookstrap-query

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

FAQPage Schema
How do I query a SurrealDB knowledge base using natural language?

Translate natural language questions into semantically meaningful SurrealDB queries to explore your knowledge base through semantic search, graph traversal, timeline, and source-citation queries that retrieve sections, characters, events, and sources.

What do I need to run natural language queries against SurrealDB?

You need a running SurrealDB instance and a configured environment with a bookstrap.config.json file containing an embeddings provider to generate the semantic queries.

Can I trace sources and citations for answers retrieved from a book knowledge base?

Yes, the query process surfaces supporting sources and citations to verify claims, allowing you to trace knowledge back to its origins within the retrieved sections and events.

Does this approach support combining graph traversal and timeline queries for deeper exploration?

Yes, it supports interactive exploration through iterative refinement and hybrid queries that combine multiple query types like graph traversal and timeline for deeper insights.

What are the limitations of using natural language queries for SurrealDB exploration?

This approach requires a pre-configured SurrealDB instance and an embeddings provider; without these environment dependencies configured in bookstrap.config.json, it cannot generate the semantic queries needed for exploration.