원클릭으로 Manus에서 모든 스킬 실행

kdp-epub

스타82

포크32

업데이트2026년 5월 31일 05:33

Build and validate a KDP-ready reflowable EPUB 3 of *No One Did It* from the v5 source of truth, conforming to the Amazon Kindle Publishing Guidelines. Use when the user wants to compile, build, export, or validate the Kindle / EPUB / KDP edition of the book. Governed by rule 16-kdp-epub. Produces dist/no-one-did-it.epub.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

xiaolai

xiaolai/no-one-did-it

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

/kdp-epub — Build the Kindle/KDP EPUB

Produce the Amazon KDP edition as a reflowable EPUB 3, compiled from the v5 canonical text and validated to the gates in .claude/rules/16-kdp-epub.md. The EPUB is a derived artifact — fix text in book/chapters-v5/, never in the EPUB.

When to use

"compile the epub", "build the Kindle edition", "export for KDP", "validate the ebook".
After any v5 text change that should reach the Kindle edition (rebuild from source).

Prerequisites (the build script enforces all of these — fail-loud)

Source clean. dist/manuscript-v6.md is current (re-run pipelines/epub/assemble_v6_manuscript.py if v6 chapters changed) and contains no raw [CITE:] markers and no [EVIDENCE NEEDED]. Resolve cites to endnotes first (Stephen / the source-ledger pipeline). Current state: 3 [CITE:] markers remain (ch08 ×1, ch12 ×2) — these block a non-draft build until resolved.
Metadata filled. book/design/epub/metadata.yml has no TODO tokens (author, publisher, identifier). Generate a stable identifier once: python3 -c 'import uuid;print("urn:uuid:"+str(uuid.uuid4()))'.
Cover present and conforming. book/design/epub/cover.jpg = 2560×1600 JPEG, 1.6:1, sRGB, title + author composited (rule 16). Current state: the design delivery has no title-composited ≥1600px cover — a conforming cover must be produced first. Use --draft to build a coverless proof in the meantime.

Tooling (all present on this machine)

pandoc 3.9 (build) · epubcheck v5.3.0 (gate 1) · Kindle Previewer 3 CLI + app (gate 2) · sips (cover dimension check) · java.

Procedure

1. Assemble + clean the source

python3 pipelines/epub/assemble_v6_manuscript.py    # refresh the manuscript from v6
# (the build script also runs this automatically when the cache is stale)
grep -rn '\[CITE:' dist/manuscript-v6.md  # must be empty before a real build

Resolve any [CITE:] to endnotes via the source-ledger cards (Stephen locks the anchor, then the cite becomes a numbered note). Do not hand-delete cites.

2. Prepare cover + metadata

Drop the conforming cover at book/design/epub/cover.jpg (or pass --draft to skip).
Fill book/design/epub/metadata.yml (author / publisher / identifier).

3. Build

python3 pipelines/epub/build_kdp_epub.py            # full, gated build  -> dist/no-one-did-it.epub
python3 pipelines/epub/build_kdp_epub.py --draft    # coverless text proof for review

What the build does: guards source + metadata + cover; folds the back-of-book # Notes definitions into pandoc popup footnotes (epub:type="noteref"/"footnote") while keeping the Selected Bibliography; runs pandoc --to epub3 --split-level=1 --toc with kdp.css, the metadata, and the cover.

4. Validate (both hard gates must pass before upload)

python3 pipelines/epub/validate_kdp_epub.py dist/no-one-did-it.epub

Gate 1 — epubcheck: zero fatals/errors (triage warnings).
Gate 2 — Kindle Previewer 3: converts to KFX/KPF cleanly. Authoritative Kindle gate — a file can pass epubcheck and still break on a Paperwhite. If the CLI isn't on PATH, open dist/no-one-did-it.epub in the Kindle Previewer 3 app and run the convert.
Structure checks: cover declared, footnote popups present, no leaked [CITE:]/[^N].

5. Pre-flight checklist (manual, in Kindle Previewer)

Cover renders crisp; title + author legible at thumbnail size.
TOC navigates to every chapter + the Bibliography; no page numbers in TOC.
A footnote tap opens a pop-up (not a jump to the back); back-link returns.
A part-divider image displays with alt text; single-column everywhere.
Reader font-size changes reflow cleanly (no fixed-px overflow).
Epigraphs (incl. CJK/Greek/Arabic/Sanskrit) render; no tofu boxes.
No raw [CITE:], [^N], or ## beat-name text anywhere.

6. Upload

Upload dist/no-one-did-it.epub to KDP as the manuscript; upload the 2560×1600 JPEG as the marketing cover separately. KDP assigns the ASIN.

Guardrails

The scan-kdp-epub-css.py hook warns at edit time if book/design/epub/*.css introduces KDP-unsupported constructs (position:, fixed pt/px type/margins, height on text, forced black/white backgrounds).
Never produce .mobi (dead format). Never edit the .epub as the master.
Reflowable only: the fixed-layout dossier interiors do not survive reflow — a separate fixed-layout edition would be a different pipeline.

Troubleshooting

Symptom	Cause / fix
`FAIL: N unresolved [CITE:]`	resolve cites to endnotes in v5, re-assemble, rebuild
`FAIL: metadata.yml ... TODO`	fill author/publisher/identifier in `book/design/epub/metadata.yml`
`FAIL: cover ... non-conforming`	export a 2560×1600 sRGB JPEG (1.6:1) with title+author, or `--draft`
epubcheck errors on fonts	embed only OTF/TTF, or drop embedded fonts and let Kindle use reader font
notes render inline, not popup	confirm `epub:type` markup survived; check pandoc version ≥3.0
pandoc: `--split-level` unknown	pandoc < 3.0; upgrade (this repo expects 3.9)

이 저장소의 다른 Skills

같은 저장소

callback-audit

xiaolai/no-one-did-it

Audit the book-level callback graph that tracks setup → payoff edges across chapters. Verifies every planted anchor has its declared downstream payoff and every payoff still has its upstream plant. Catches orphaned plants and orphaned payoffs. Reads `book/registries/callback-graph.yml`; runs book-wide when any graph chapter is rewritten. Cousin of fair-clue-audit (which covers chapter-internal recognition).

2026-05-3182

case-file-method

xiaolai/no-one-did-it

Build a structured responsibility-laundering case file from a historical, political, legal, corporate, war, or AI event.

2026-05-3182

chapter-blueprint

xiaolai/no-one-did-it

Turn approved case files into chapter architecture for serious trade nonfiction.

2026-05-3182

chapter-defect-diagnose

xiaolai/no-one-did-it

Diagnose a chapter against the 10 reader-experience values in rule 12 (5 core + 5 craft) and build a defect map naming which values fail, with cited prose evidence, and recommending one of the five treatment classes from rule 08. Output is `process/defect-map/<n>-<slug>.md` plus a treatment-class row appended to `book/registries/treatment-classes.yml`.

2026-05-3182

citation-hygiene

xiaolai/no-one-did-it

Prepare citation-ready notes for drafting, fact-checking, and legal review.

2026-05-3182

cite-density-audit

xiaolai/no-one-did-it

Audit chapter prose for verbose inline `[CITE:]` markers that violate rule-13's slug-only invariant. Inline `[CITE:]` brackets must carry only card slugs (separated by `;` for multi-source claims); full citation apparatus lives in the source-ledger card and is compile-generated as Chicago NB endnote. Catches the failure mode where citation metadata leaks from card to prose. Cousin to `scan-cite-density.py` (the cheap pattern-level pass); this skill is the deeper read.

2026-05-3182

name	kdp-epub
description	Build and validate a KDP-ready reflowable EPUB 3 of No One Did It from the v5 source of truth, conforming to the Amazon Kindle Publishing Guidelines. Use when the user wants to compile, build, export, or validate the Kindle / EPUB / KDP edition of the book. Governed by rule 16-kdp-epub. Produces dist/no-one-did-it.epub.

/kdp-epub — Build the Kindle/KDP EPUB

When to use

"compile the epub", "build the Kindle edition", "export for KDP", "validate the ebook".
After any v5 text change that should reach the Kindle edition (rebuild from source).

Prerequisites (the build script enforces all of these — fail-loud)

Source clean. dist/manuscript-v6.md is current (re-run pipelines/epub/assemble_v6_manuscript.py if v6 chapters changed) and contains no raw [CITE:] markers and no [EVIDENCE NEEDED]. Resolve cites to endnotes first (Stephen / the source-ledger pipeline). Current state: 3 [CITE:] markers remain (ch08 ×1, ch12 ×2) — these block a non-draft build until resolved.
Metadata filled. book/design/epub/metadata.yml has no TODO tokens (author, publisher, identifier). Generate a stable identifier once: python3 -c 'import uuid;print("urn:uuid:"+str(uuid.uuid4()))'.
Cover present and conforming. book/design/epub/cover.jpg = 2560×1600 JPEG, 1.6:1, sRGB, title + author composited (rule 16). Current state: the design delivery has no title-composited ≥1600px cover — a conforming cover must be produced first. Use --draft to build a coverless proof in the meantime.

Tooling (all present on this machine)

pandoc 3.9 (build) · epubcheck v5.3.0 (gate 1) · Kindle Previewer 3 CLI + app (gate 2) · sips (cover dimension check) · java.

Procedure

1. Assemble + clean the source

python3 pipelines/epub/assemble_v6_manuscript.py    # refresh the manuscript from v6
# (the build script also runs this automatically when the cache is stale)
grep -rn '\[CITE:' dist/manuscript-v6.md  # must be empty before a real build

Resolve any [CITE:] to endnotes via the source-ledger cards (Stephen locks the anchor, then the cite becomes a numbered note). Do not hand-delete cites.

2. Prepare cover + metadata

Drop the conforming cover at book/design/epub/cover.jpg (or pass --draft to skip).
Fill book/design/epub/metadata.yml (author / publisher / identifier).

3. Build

python3 pipelines/epub/build_kdp_epub.py            # full, gated build  -> dist/no-one-did-it.epub
python3 pipelines/epub/build_kdp_epub.py --draft    # coverless text proof for review

4. Validate (both hard gates must pass before upload)

python3 pipelines/epub/validate_kdp_epub.py dist/no-one-did-it.epub

Gate 1 — epubcheck: zero fatals/errors (triage warnings).
Gate 2 — Kindle Previewer 3: converts to KFX/KPF cleanly. Authoritative Kindle gate — a file can pass epubcheck and still break on a Paperwhite. If the CLI isn't on PATH, open dist/no-one-did-it.epub in the Kindle Previewer 3 app and run the convert.
Structure checks: cover declared, footnote popups present, no leaked [CITE:]/[^N].

5. Pre-flight checklist (manual, in Kindle Previewer)

Cover renders crisp; title + author legible at thumbnail size.
TOC navigates to every chapter + the Bibliography; no page numbers in TOC.
A footnote tap opens a pop-up (not a jump to the back); back-link returns.
A part-divider image displays with alt text; single-column everywhere.
Reader font-size changes reflow cleanly (no fixed-px overflow).
Epigraphs (incl. CJK/Greek/Arabic/Sanskrit) render; no tofu boxes.
No raw [CITE:], [^N], or ## beat-name text anywhere.

6. Upload

Upload dist/no-one-did-it.epub to KDP as the manuscript; upload the 2560×1600 JPEG as the marketing cover separately. KDP assigns the ASIN.

Guardrails

The scan-kdp-epub-css.py hook warns at edit time if book/design/epub/*.css introduces KDP-unsupported constructs (position:, fixed pt/px type/margins, height on text, forced black/white backgrounds).
Never produce .mobi (dead format). Never edit the .epub as the master.
Reflowable only: the fixed-layout dossier interiors do not survive reflow — a separate fixed-layout edition would be a different pipeline.

Troubleshooting

Symptom	Cause / fix
`FAIL: N unresolved [CITE:]`	resolve cites to endnotes in v5, re-assemble, rebuild
`FAIL: metadata.yml ... TODO`	fill author/publisher/identifier in `book/design/epub/metadata.yml`
`FAIL: cover ... non-conforming`	export a 2560×1600 sRGB JPEG (1.6:1) with title+author, or `--draft`
epubcheck errors on fonts	embed only OTF/TTF, or drop embedded fonts and let Kindle use reader font
notes render inline, not popup	confirm `epub:type` markup survived; check pandoc version ≥3.0
pandoc: `--split-level` unknown	pandoc < 3.0; upgrade (this repo expects 3.9)