Pdf to ebook
Convert a PDF file to ebook formats (epub, mobi, azw3/Kindle) using Calibre. Use when the user wants to convert a PDF to an ebook format.From its SKILL.md
npx -y skills add cgbarlow/skills --skill pdf-to-ebookAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 18 stars18 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.8 KB, as published. Nobody here has run it
PDF to Ebook Converter
Convert a PDF to one or more ebook formats using Calibre's ebook-convert.
Arguments
$ARGUMENTS — space-separated: first arg is the PDF path, optional second arg is the format(s).
- Format options:
epub,mobi,azw3,all - If no format is provided, ask the user which formats they want before proceeding.
Workflow
Step 1 — Parse arguments
Extract the PDF path from $ARGUMENTS. If a format argument is also present, use it. If not, ask:
Which formats would you like to export?
- epub
- mobi
- azw3 (Kindle, recommended over mobi)
- all (epub + mobi + azw3)
Wait for the user's response before continuing.
Step 2 — Validate inputs
- Confirm the PDF file exists. If not, report the error and stop.
- Check Calibre is installed:
If missing, tell the user to install it:which ebook-convert- Linux:
sudo apt install calibre - macOS:
brew install calibre - Then stop.
- Linux:
Step 3 — Check for scanned/image-only PDF (optional but recommended)
Run a quick text extraction check:
ebook-convert "<input.pdf>" /tmp/pdf_text_check.txt 2>/dev/null && wc -c /tmp/pdf_text_check.txt
If the output is fewer than 500 characters, the PDF is likely image-based (scanned). Warn the user:
This PDF appears to be scanned or image-based and may convert poorly. Would you like to run OCR first using
ocrmypdf? (Requires:pip install ocrmypdfandtesseract)
If they say yes:
ocrmypdf "<input.pdf>" "<input_ocr.pdf>"
Use the OCR'd file for all subsequent conversions.
Step 4 — Convert
Derive the output base name from the input file (strip .pdf extension).
For each requested format, run:
ebook-convert "<input.pdf>" "<basename>.<format>" \
--output-profile kindle_oasis \
--enable-heuristics
Format-specific notes:
- epub: drop
--output-profile; use--output-profile tabletinstead - mobi: use
--output-profile kindle - azw3: use
--output-profile kindle_oasis(best Kindle compatibility)
Run conversions sequentially. Report each one as it completes.
Step 5 — Report results
List each output file with its path and size:
ls -lh "<basename>.epub" "<basename>.mobi" "<basename>.azw3" 2>/dev/null
If any conversion failed, show the error output from ebook-convert.
Example invocations
/pdf-to-ebook book.pdf
/pdf-to-ebook book.pdf epub
/pdf-to-ebook book.pdf all
/pdf-to-ebook /path/to/document.pdf azw3