book-convert

Installation
SKILL.md

Book Convert — Phase 01: Source → Markdown

Purpose

Convert a single book source (PDF or EPUB) into the canonical Markdown shape used by the rest of the pipeline:

  • One .md file per chapter under corpus/alan_hirsch/<book-slug>/chapters/
  • <!-- page: N --> HTML-comment page markers at the start of each source page
  • [^N] Markdown footnote references in body, [^N]: <citation> definitions at chapter end (or in a separate Notes file)
  • Headings preserved at correct levels (chapter title ##, section ###, sub-section ####)
  • Tables, lists, blockquotes, and equations preserved
  • Images extracted to corpus/alan_hirsch/<book-slug>/images/figure-NN.<ext> and referenced via Markdown image syntax

This is lossless — every word, footnote, page number, table cell, and figure caption from the source must appear in the output. Phase 01b (book-validate) proves it.

Invocation

$ARGUMENTS should specify:

Installs
1
GitHub Stars
1
First Seen
Jun 4, 2026
book-convert — joshuashepherd/my-skills