A valid file and a complete file are different things. This skill counts what every format of a finished book actually carries, checks the pixels and alt text inside it, and converts to formats beyond the usual six. It never touches the prose.
Each opens only when the request needs it. Each rule inside is tagged with the incident, the dated vendor page, or the word SPECULATIVE.
Inventory every image, decide informative or decorative, check pixels against print and ebook, and record what a full-bleed image becomes when the layout changes.
Which formats beyond the six-file set a book needs, and how to make each from one master. The shelf run found the final-set EPUB carrying 1 image, and the Markdown master it most likely came from has none to give it (inferred, not recorded).
The same images in the same order with the same alt text, each format passed by its real checker. Validity and census, side by side, every time.
The shipped set for Are You Actually Hungry? (files dated 2026-06-15), checked 2026-09-26. The book is the operator's own. Paths shortened.
Validating using EPUB version 3.4 rules. No errors or warnings detected. Messages: 0 fatals / 0 errors / 0 warnings / 0 infos
format raster vector refs alt d/e/m notes HTML source 14 75 89 1/13/0 PDF 22 n/a n/a n/a min 267 ppi; colour gray,rgb EPUB 1 0 1 0/0/0 DOCX 0 0 0 0/0/0 order check: source 14 vs EPUB 1 DIFFERS: 13 source image(s) absent from EPUB
The same source, converted again with five source-side fixes, into a scratch folder. The shipped files were not touched.
format raster vector refs alt d/e/m HTML source 18 75 93 17/17/0 PDF 22 n/a n/a n/a EPUB 18 20 93 17/76/0 DOCX 34 20 93 17/76/0 order check: source 18 vs EPUB 18 same images, same order.
| Shipped EPUB | Rebuilt EPUB | |
|---|---|---|
| epubcheck | 0 errors | 0 errors |
| Raster images | 1 (the cover) | 18, source order |
| Figures with alt text | 0 | 16, the author's own labels |
| Size | 2.9 MB | 7.2 MB (interior images capped at 1200×1800) |
The rebuild shows the images can survive; it is not a drop-in replacement, because the print HTML it came from is a different edition of the text. For a book that is already live, the fix is inserting the images into the shipped file: 0 words changed, checked by a flattened-text diff.
A second real book, BikYasa Yoga, fails the other way: its EPUB has 124 images against 121 in its PDF (and 108 in its DOCX; whether they are the same images was not tested) and fails epubcheck with 157 errors, 124 of them images missing the required alt. A validator and a count answer different questions.
The run above is the only evidence this page carries: one shipped book measured, one rebuilt and re-validated. There are no testimonials or usage figures yet.
SKILL.md triggers on requests like "do the formats match?" and "why is my EPUB missing the pictures?".epubcheck (brew install epubcheck) and poppler (pdfimages) for the PDF column.python3 tools/format-census.py --pdf book.pdf --epub book.epub --docx book.docx. Add --html source.html --src-dir <dir> to test image order.No. It never rewrites, trims or corrects prose. It also does not write alt text or captions for you; it lists the images that need them and asks the author.
No. That is Publishing Preparation. This skill takes its output and the source as input. A defect in the six-file EPUB or DOCX is reported here and fixed there.
No. Counts and byte order are a tripwire. The PDF's image order is not tested, and neither is placement or how the file reads on a device. Open a page of each format that has a full-bleed or floated image.
They are dated the day they were fetched, and no vendor page showed a revision date. Re-open the page before relying on a number for a title.
Cover design, title and jacket copy, audio, video, fixed-layout children's books, vendor accounts and uploads.