BotCurrent↗
← Back to examples

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

  1. 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.

  2. 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

  1. 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

  2. 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
  1. Inspect a supplied copy and plan outputs separately; no conversion-tool installation or external upload.

Compatibility unknowns
  1. Current conversion libraries, ebook-reader rendering and exact runtime compatibility are unknown.

External actions requiring approval
  1. 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
  1. 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

  1. 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.

  2. 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
  1. Inventory structural features and define fidelity priorities.

Ongoing review
  1. Review representative layouts and every navigation class.

Unknowns
  1. 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
  1. Resolve every note link; retain the figure; mark the ambiguous heading for review; convert nothing.

Stop conditions
  1. Stop if text order or reuse rights cannot be established without guessing.

Limits

  1. Valid ebook packaging does not establish faithful content, accessible navigation or consistent rendering across readers.

Tasks: Documents & files

Useful for: Content creatorPersonal and household

Editorial relevance from the title and source-supported actions; not evidence of the operator’s occupation.
Hermes AgentIndependent testing: No

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.