gongnyang/bookforge

What it solves

Bookforge is an agentic skill designed to automate the creation of professional, commercial-grade e-book PDFs from Markdown content. It eliminates the manual typesetting typeseting and layout design process by providing a system of style packs, automated build scripts, and a rigorous quality control (QC) gate system that prevents low-quality or improperly formatted documents from being finalized.

How it works

The project uses a combination of rendering engines (Typst and Chromium/HTML) and a set of predefined style packs (e.g., practical, insight, academic, essay, business, magazine) to transform Markdown into a PDF.

Key components include:

• Style Packs: Each pack contains a specific layout rulebook, font settings, and color tokens to ensure a consistent professional look.
• Diagram Tracks: It supports two types of diagrams: AntV Infographic DSL (rendered via a committed vendor bundle for SSR) and authored SVGs, which are normalized and validated for font size and color palette.
• TOC System: A flexible table of contents system with six different layouts that can be adjusted per book.
• QC Gates: A system of 17 mechanical gates (G0-G17) that check for everything from font embedding (Type3 glyphs) and page geometry (overflow, collisions) to content density and WCAG color contrast.
• Mutation Suite: A testing framework that injects defects into books to ensure the QC gates are correctly detecting errors without false positives.

Who it’s for

This tool is for AI agents (specifically Claude Code and OpenAI Codex) and developers who want to generate high-quality, print-ready digital books without needing professional typesetting software or manual layout adjustments.

Highlights

• Commercial-Grade Layouts: Six distinct styles based on real-world commercial publishing measurements.
• Rigorous Quality Control: 17 automated gates that prevent the final PDF from being generated if layout or accessibility errors are found.
• Integrated Diagramming: Native support for AntV and custom SVG diagrams with automatic normalization.
• ** uma a professional-grade PDF output with a dedicated mutation suite to prevent regression in quality checks.
• Agentic Workflow: Supports both "topic mode" (research to publication) and "manuscript mode" (ingestion of existing drafts).