Can I add my own books to the library?

Yes, you can use the add-pdf or add-md commands to index new documents from your local file system into the Candlekeep database.

What file formats does Candlekeep support?

Currently, Candlekeep supports PDF files (via PyMuPDF conversion) and Markdown files with YAML frontmatter for metadata.

How does Candlekeep help with AI accuracy?

It allows Claude to reference actual text from your local books rather than relying on its training memory, providing precise citations and reducing hallucinations.

Does it store my books in the cloud?

No, Candlekeep is a local-first system. All books, databases, and converted files are stored on your local machine in the ~/.candlekeep directory.

Is it efficient with LLM tokens?

Yes, Candlekeep uses a progressive workflow—listing books and viewing the Table of Contents first—to ensure only the most relevant pages are sent to the AI.

Candlekeep Knowledge Base

Name: Candlekeep Knowledge Base
Author: SaharCarmel

bySaharCarmel

•

Learning & Documentation

Accesses and queries your personal library of books and documents to provide grounded answers with precise page citations.

Candlekeep transforms Claude into a sophisticated research assistant by providing direct access to a locally stored library of PDF and Markdown books. Unlike standard AI responses that rely on training data, Candlekeep allows Claude to browse table of contents, navigate specific pages, and extract verbatim source material from your own files. This ensures that technical documentation, academic texts, and personal reference materials are used to generate highly accurate, cited responses while maintaining a local-first privacy approach within your development workflow.

Key Features

01Local PDF and Markdown library management with SQLite tracking

021 GitHub stars

03Automatic metadata extraction and book indexing

04Progressive disclosure workflow to minimize token usage and costs

05Precise page extraction with markdown markers for source grounding

06Hierarchical Table of Contents (TOC) navigation for efficient document mapping

Use Cases

01Answering complex research questions using authoritative personal sources instead of general AI memory

02Referencing specific programming books or technical documentation during coding sessions

03Extracting and summarizing specific chapters or page ranges from local PDF libraries

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add saharcarmel/sahar-claude-code-marketplace candlekeep

For use in Claude.ai and ChatGPT

Download Skill