Community recipe · Tool workflows
Convert a PDF book into a structured ebook
Source-backed example. Practical decision guidance is proposed and untested; this is not a full implementation guide.
The problem
A PDF book can be awkward to read as an ebook when chapter navigation, illustrations and endnote links do not transfer cleanly.
Agent job
Convert a text-layer PDF into a structured ebook, preserve illustrations, build navigation and linked endnotes and check the output.
Expected output
An ebook with chapter navigation, cover, illustrations and linked endnotes.
Where this framing comes from
- Core problem: Editorial purpose framing
- Agent job: Editorial purpose framing
- Expected output: Editorial purpose framing
- Relevant job roles: Editorial purpose framing
- Benefit type: Editorial purpose framing
Editorial framing and outcome limits
Describes the task’s purpose and intended output; measured benefit, safe unsupervised operation and successful delivery are not established by this framing.
Editorial synthesis based on the linked source. This framing does not add evidence of successful delivery or results.
Case-specific decision guidance · untested
Case-specific decision guidance and first checks are original proposals. The linked source supports the attributed task; this added guidance has not been executed.
Read the attributed source evidence and original caveats below ↓
Why use this
A reader with a PDF book may find fixed pages awkward on an ebook reader, especially when chapters and notes lack usable navigation. Conversion can preserve the words while losing the relationships that make the book readable.
This job could create a structured ebook candidate whose chapter boundaries, illustrations and note links can be checked. Reviewing those elements separately helps the owner avoid mistaking a successful export for a faithful reading experience.
Why an agent / simpler alternative
- Useful judgment
Infer document structure from available text and layout, identify exceptions and reconcile navigation with the book's actual organization.
- Simpler alternative
Use a publisher-provided ebook or a simple conversion for a clean, uncomplicated document.
- Unsuitable when
The PDF lacks an adequate text layer, reuse rights are unclear or fidelity needs exceed available review.
Proposed inputs
- Name
Authorized PDF copy
- Owner
Rights holder or reader
- Minimum scope
Complete text-layer file with intended usage rights
- Quality check
Check missing pages, text extraction and illustration quality
- Name
Conversion brief
- Owner
Owner
- Minimum scope
Required chapters, cover and note behavior
- Quality check
Identify unusual layouts and accessibility needs
Access and setup — proposed or unknown
- Proposed minimum
Inspect a supplied copy and plan outputs separately; no conversion-tool installation or external upload.
- Compatibility unknowns
Current conversion libraries, ebook-reader rendering and exact runtime compatibility are unknown.
- External actions requiring approval
Uploading the book, installing dependencies, distributing converted files or commercial reuse requires appropriate authorization.
Expected deliverable and review checks
- Proposed artifact
Ebook candidate plan with chapter/navigation map and illustration/endnote reconciliation checklist.
- Critical checks
Match chapter order; retain complete cover and figures; verify note targets and return paths; inspect reading order.
- Missing output evidence
This overlay adds no new output inspection, execution or validation; consult the referenced canonical source outcome limits.
Failure signals and proposed responses
- Signal
Footnote markers become plain body text
- Why it matters
Readers lose the intended reference relationship
- Proposed response
Map markers to notes explicitly or flag manual repair.
- Signal
Multi-column extraction interleaves paragraphs
- Why it matters
All text may exist but read incorrectly
- Proposed response
Compare sequence against the PDF before conversion.
Effort and cost — unknown
- Setup work
Inventory structural features and define fidelity priorities.
- Ongoing review
Review representative layouts and every navigation class.
- Unknowns
Text cleanup, image handling, reader compatibility and conversion costs are unknown.
First check — proposed, unexecuted
- Status
proposed_unexecuted
- Synthetic fixture
Invent a two-chapter PDF outline with one illustration, two endnotes and an ambiguous heading; draft its navigation map.
- Acceptance checks
Resolve every note link; retain the figure; mark the ambiguous heading for review; convert nothing.
- Stop conditions
Stop if text order or reuse rights cannot be established without guessing.
Limits
Valid ebook packaging does not establish faithful content, accessible navigation or consistent rendering across readers.
Editorial candidate. This is source-backed reporting or a documented workflow. BotCurrent has not independently tested this task. A proposed Canadian adaptation is not evidence of a Canadian deployment or compliance certification.
Original source
https://github.com/moonlight-lupin/agent-skills/blob/main/productivity/pdf2epub/SKILL.md ↗Attributed to: moonlight-lupin
Community recipe- Original action type
- tool_action
- What the source supports
- Inspects text-layer PDFs, converts chapter structure and contents navigation, renders complete covers, preserves illustrations and constructs linked endnotes, then checks the output.
- Source outcome limits
- This community recipe describes a procedure; it does not prove successful execution or independently reproduced results.
- Evidence attribution caveat
- This community recipe describes a procedure; it does not prove successful execution or independently reproduced results.
- Source approval description
- Not specified.
- Named tools
- Python pdf2epub.py; PyMuPDF; ebooklib; Pillow
- Model or version
- Recipe skill version 1.2.1; Hermes runtime/model unspecified
- Publication date
- Unknown
- Source last checked
- 2026-10-14
- Demonstrated in Canada
- Unknown
- Canadian availability
- Unknown
- Proposed Canadian adaptation
- Check Canadian copyright permissions and English/French language metadata; do not bypass DRM.
- Recommended approval boundaries
- Use authorized source books and review chapter boundaries, cover and links before distribution.