markdown-to-booklisted
Install: claude install-skill dzivkovi/claude-skills
# markdown-to-book
One source folder of markdown chapters, three published editions, one basename:
| Edition | Audience | What makes it that edition |
|---|---|---|
| `.md` | An AI agent (context handoff) | Single concatenated file, provenance frontmatter, Mermaid kept as live fences (machine-readable source beats a picture) |
| `.epub` | A human reading or listening (Kindle, TTS) | Cover, combined TOC, Mermaid rendered to PNG |
| `.pdf` | A human printing or skimming | Page/version/date stamps, Mermaid rendered as vector |
They are editions of one book, never three documents. **The lockstep rule: any edit to a source chapter invalidates all three; rebuild all three in the same session, or say plainly which ones are stale.** Filenames never carry version suffixes in a repo - git history is the version axis; note content changes concisely in the intro's "Edition notes" block instead. Version-suffixed names belong only in throwaway locations (Downloads) where generations coexist as loose files.
## Step 0 - scope check and dependencies
A single markdown file needs no bundling: hand it to `markdown-to-epub` or `markdown-to-pdf` directly and stop here. This skill earns its keep when there are multiple files whose value depends on order and togetherness.
**Sibling-skill dependency (check FIRST):** the EPUB and PDF steps call the `markdown-to-epub` and `markdown-to-pdf` skills' own scripts and stylesheet (`make_cover.py`, `epub.css`, `print_markdown.py`). Verify both skill fol