ytb-books: Book Content Automation with Neo4j GraphRAG

Automating book content creation for YouTube videos just got significantly more powerful. The ytb-books skill pack brings enterprise-grade knowledge graph technology to your Claude Code workflow, enabling true end-to-end book-to-video automation.

What is ytb-books?

ytb-books is an open-source skill pack that transforms how you create educational YouTube content from books and academic texts. Unlike simple text-to-video tools, ytb-books leverages Neo4j GraphRAG (Graph Retrieval-Augmented Generation) to understand the semantic relationships between concepts in your source material, creating coherent, context-aware video episodes.

The core innovation is its graph database architecture. Instead of treating book content as flat text, ytb-books structures knowledge as interconnected nodes: Documents → Episodes → Scenes → BookChunks. This allows intelligent navigation through complex material, automatic identification of related concepts, and generation of pedagogically sound learning sequences.

How it Works: The End-to-End Pipeline

The ytb-books automation pipeline consists of several tightly integrated services:

1. Neo4j Graph Database Integration

The foundation is Neo4j, a high-performance graph database. ytb-books stores your book content using a sophisticated schema where Documents contain Episodes, Episodes contain Scenes, and Documents also contain BookChunks for retrieval. The service provides full CRUD operations for managing this knowledge graph, including linking episodes in sequence with NEXT relationships.

2. Content Planning with AI

Once your book content is structured in Neo4j, the ContentPlannerService uses AI to generate coherent video scenarios. It doesn't just extract random paragraphs—it understands the logical flow of your material and creates scene-by-scene narratives that build understanding progressively.

3. Mathematical Formula Rendering

For STEM content creators, ytb-books includes specialized LaTeX rendering capabilities. The MathFormulaService converts complex mathematical expressions into high-quality PNG images suitable for video overlays, or converts them to Unicode text for subtitles and TTS narration. It uses MathJax v4 with careful configuration to avoid Node.js crashes while ensuring perfect rendering on dark backgrounds.

Technical Implementation Details

ytb-books is built as a TypeScript microservice architecture with 14 distinct services and 11 handlers. The key components include:

• BooksVideoService.ts: The main orchestrator that coordinates the entire pipeline
• ContentPlannerService.ts: AI-powered scenario generation
• GhibliImageService.ts: Image generation integration
• MathFormulaService.ts: LaTeX to PNG/Unicode conversion
• Neo4jService.ts: Graph database CRUD operations

The system requires several dependencies: Neo4j database, NanoBanana API for image generation, FFmpeg for video composition, and Gemini TTS for voice synthesis. All configurations are centralized in the BOOKS_PROJECT_CONFIG file.

Getting Started

To use ytb-books in your Claude Code environment:

/plugin marketplace add https://github.com/clickaround/marketplace
/plugin install ytb-books@clickaround

After installation, you'll need to configure your Neo4j instance and set up the required API keys. The complete documentation is available in the GitHub repository.