epub

# EPUB Skill ## When to use ### EPUB → PDF - Convert EPUB books, papers, or distributed documents to PDF for reading and analysis - Preserve layout and formatting before text extraction via pdftoppm - Archive EPUB content in a fixed-layout format - Prepare EPUBs for downstream processing (rendering, analysis, synthesis) ### PDF → EPUB - Convert papers and PDFs to reflowable EPUB format for ereader distribution - Compress PDFs into smaller, device-friendly EPUB archives - Auto-detect chapters and structure for better reading experience - Redistribute research materials in open formats ## Workflow ### EPUB → PDF (for analysis) 1. **Check for calibre** → install if missing (`brew install calibre`) 2. **Convert EPUB → PDF** using `ebook-convert` with formatting options 3. **Validate output** → confirm PDF rendered correctly 4. **Render pages** → use pdftoppm to extract visual content 5. **Analyze** → pass to PDF skill for text extraction and synthesis ### PDF → EPUB (for distribution) 1. **Check for calibre** → install if missing 2. **Convert PDF → EPUB** using `ebook-convert` with reflowable settings 3. **Auto-detect chapters** → ebook-convert scans for structure 4. **Validate compression** → confirm EPUB is smaller than PDF 5. **Archive** → save EPUB to `research/sources/` for distribution or ereader use ## Usage ### EPUB → PDF (basic) ```bash ebook-convert input.epub output.pdf ``` ### EPUB → PDF (with layout preservation options) ```bash ebook-convert input.epub ...