Automatically converts PDF books to EPUB format with chapter detection, image optimization, and footnote hyperlinking. Ideal for publishers and operations teams managing digital content workflows. Integrates with Claude agents.
git clone https://github.com/koreyba/Claude-Skill-pdf-to-epub.gitThis Claude Code skill automates PDF-to-EPUB conversion by analyzing document structure to detect chapters based on font analysis, extracting and compressing images for e-readers, and converting footnote references into clickable hyperlinks. It handles both single-column and multi-column layouts with configurable reading order detection and includes quality validation to verify text completeness and preserve reading order. The skill follows a four-phase workflow—analyze, convert, validate, and adapt—making it suitable for publishers managing digital content workflows and operations teams handling batch conversions. Configuration examples support fiction books, academic papers, and other document types.
[{"step":"Prepare your PDF file and note the required metadata (title, author, language). Ensure the PDF has clear chapter headings and footnotes for optimal conversion.","tip":"Use Adobe Acrobat or PDF-XChange Editor to check for hidden chapter markers or inconsistent formatting that might affect the EPUB structure."},{"step":"Run the conversion using the prompt template. Replace [PDF_FILE_PATH] with the local path to your PDF, and fill in the other placeholders (e.g., [TARGET_DPI]=150, [BOOK_TITLE], [OUTPUT_PATH]).","tip":"For batch processing, use a script to iterate over multiple PDFs. Example: `for file in *.pdf; do convert \"$file\" \"${file%.pdf}.epub\"; done` (adjust for your environment)."},{"step":"Review the output EPUB in a dedicated reader like Calibre or Adobe Digital Editions. Verify chapter structure, image quality, and footnote links.","tip":"Use Calibre's 'EPUB Editor' to manually adjust chapter titles or fix any formatting issues that the auto-detection missed."},{"step":"Validate the EPUB using the W3C EPUB Validator (https://validator.w3.org/epubcheck/) to ensure compliance with EPUB standards.","tip":"Fix any validation errors before distribution to avoid rejections from platforms like Amazon KDP or Kobo."},{"step":"Distribute the EPUB to your desired platforms (e.g., Amazon KDP, IngramSpark, or your own website). Consider adding DRM if required by your distribution strategy.","tip":"For e-commerce, use tools like PublishDrive or StreetLib to automate distribution to multiple retailers."}]
Convert published PDF books to EPUB for digital distribution
Batch convert academic papers and multi-column research documents
Extract and optimize images from PDFs for e-reader compatibility
Automate footnote and endnote conversion to clickable links
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/koreyba/Claude-Skill-pdf-to-epubCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Convert the PDF file at [PDF_FILE_PATH] to EPUB format with the following specifications: - Preserve chapter structure and hierarchy from [PDF_FILE_PATH]. - Optimize embedded images for EPUB compatibility (resolution: [TARGET_DPI], format: [TARGET_FORMAT]). - Hyperlink all footnotes to their corresponding endnotes or references. - Set metadata: title=[BOOK_TITLE], author=[AUTHOR_NAME], language=[LANGUAGE_CODE]. - Output the EPUB file to [OUTPUT_PATH].
``` Conversion completed successfully! File Details: - Input: /documents/advanced_algorithms.pdf (12.4 MB, 487 pages) - Output: /output/advanced_algorithms.epub (8.1 MB) Metadata Applied: - Title: Advanced Algorithms for Modern Systems - Author: Dr. Evelyn Carter - Language: en-US Processing Summary: - Chapters Detected: 24 (including preface and appendices) - Images Optimized: 112 (converted to WebP at 150 DPI) - Footnotes Hyperlinked: 487 (all linked to endnotes) - Table of Contents: Auto-generated with 3-level depth Quality Checks: - EPUB Validation: Passed (W3C EPUB Validator) - Accessibility: WCAG 2.1 AA compliant - Compatibility: Tested on Kindle, Kobo, and Apple Books Next Steps: 1. Review the EPUB in Calibre to verify chapter order and image placement. 2. Upload to your digital distribution platform (e.g., Amazon KDP, IngramSpark). 3. For enhanced distribution, consider adding DRM via [DRM_TOOL_NAME]. ```
AI assistant built for thoughtful, nuanced conversation
IronCalc is a spreadsheet engine and ecosystem
ITIL-aligned IT service management platform
Customer feedback management made simple
Enterprise workflow automation and service management platform
Automate your spreadsheet tasks with AI power
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan