bookstrap-ingest

Ingest PDFs, Markdown, HTML, and plain text into Bookstrap knowledge bases with semantic chunking and embeddings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Ingests research materials into the Bookstrap database to enable end-to-end preparation for long-form writing by converting sources into semantic chunks, embeddings, entities, and relationship structures.

Core Features & Use Cases

  • Ingests multiple sources (PDF, Markdown, HTML, and plain text) into a centralized research corpus.
  • Generates embeddings for semantic search, extracts entities (characters, locations, events, concepts), and builds graph relationships.
  • Constructs a research timeline by sequencing events and dates to support chronological storytelling and validation.

Quick Start

Run /bookstrap-ingest with your research sources to start populating the corpus.

Frequently Asked Questions about bookstrap-ingest

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

FAQPage Schema
How do I ingest research PDFs and Markdown files into a knowledge graph?

To ingest research PDFs and Markdown files into a knowledge graph, the Skill performs semantic chunking, generates embeddings, extracts entities, and builds relationship structures from your provided sources. It processes files, directories, and URLs to populate a centralized research corpus.

When do I need semantic chunking and entity extraction for research materials?

You need semantic chunking and entity extraction when preparing diverse research materials for long-form writing. This process converts unstructured PDF, HTML, and text sources into a searchable database by identifying characters, locations, and events, and mapping their relationships.

Can I build a research timeline from unstructured HTML and text documents?

Yes, you can build a research timeline from unstructured HTML and text documents. The Skill extracts entities and sequences events with their associated dates during ingestion, constructing a chronological timeline to support storytelling and historical validation.

Do I need a SurrealDB instance to perform entity extraction and generate embeddings?

Yes, you need a SurrealDB instance configured alongside an embedding provider. The database stores the extracted chunks, generated embeddings, entities, and relationship structures required to manage your research corpus effectively.

What is the best way to convert multiple research sources into a structured database?

The best way to convert multiple research sources into a structured database is through automated ingestion that handles semantic chunking and relationship construction. This approach transforms scattered files and URLs into a centralized, searchable knowledge base ready for analysis.

Are there limitations when ingesting research sources across different file formats?

Ingesting research sources supports PDF, Markdown, HTML, and plain text formats, but requires configured embedding providers and a SurrealDB instance. Sources outside these specified formats or without proper database configuration cannot be processed into the structured knowledge graph.