[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AMFH5NEK5WH12B62C22EBC":3,"skill-same:01M7AMFH5NEK5WH12B62C22EBC":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M7AMFH5NEK5WH12B62C22EBC","pipeline-book-release-engineering",null,"Use when taking a research-based manuscript from a locked draft to reproducible PDF, EPUB, cover, and release evidence; triggers on book publication, print interiors, ebook packaging, cover generation, visual QA, KDP preparation, artifact manifests, or postmortems of a manual publishing workflow.","the-vibey-project\u002Fvibey","the-vibey-project","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F329298758?v=4","01M7AJHGZ9722CTJ4JNQZVRH0Q","the vibey project","01M7AJHGZVMG2K7TGXQ6XFHVG3",5,"MIT","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fcontent-engineering-pipeline\u002Fskills\u002Fpipeline-book-release-engineering\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: pipeline-book-release-engineering\ndescription: \"Use when taking a research-based manuscript from a locked draft to reproducible PDF, EPUB, cover, and release evidence; triggers on book publication, print interiors, ebook packaging, cover generation, visual QA, KDP preparation, artifact manifests, or postmortems of a manual publishing workflow.\"\n---\n\n# Book Release Engineering\n\nBook production is a software delivery problem with a human editorial\nacceptance layer. A manuscript is source code, a book configuration is a build\nmanifest, the PDF\u002FEPUB\u002Fcovers are compiled artifacts, and the release report is\nthe evidence that the artifacts came from the intended source and passed the\ndeclared gates. The analogy is useful only if it preserves the difference:\ntypesetting can be deterministic while literary judgment remains human.\n\nThis skill is the reusable release layer for the Content Engineering Pipeline's\nPhases 4–5. It closes the gap between a publication method that describes what\nshould be checked and a repository that can prove what was checked. Use it\nafter the manuscript's structural, argument, consistency, voice, evidence, and\nplaceholder passes are complete, and before any store submission or public\ndistribution.\n\n## The governing rule: no invisible manual state\n\nIf a future release depends on a command someone remembers, a page someone\nlooked at once, a word count someone calculated in a one-off shell expression,\nor a cover decision that exists only in chat history, the process is not yet\nengineered. Convert that decision into one of four durable forms:\n\n1. **Source configuration** — a machine-readable threshold, ordering rule,\n   required apparatus list, or exception with a named reason.\n2. **Executable gate** — a check that fails with a path, line, artifact, or\n   measured value rather than a vague assertion.\n3. **Review surface** — a rendered page, contact sheet, EPUB inspection set,\n   or report that lets a human make the remaining judgment quickly.\n4. **Evidence record** — a versioned JSON manifest containing the source\n   revision, commands, tool versions, hashes, counts, warnings, and decisions.\n\nDo not turn a judgment into a fake Boolean merely to make a dashboard green.\nRecord it as an explicit human decision attached to the evidence bundle.\n\n## Release graph\n\nThe release command must own this dependency graph:\n\n```text\nsource inventory and prose audit\n        │\n        ▼\nrelease-readiness contract ──► metadata, research, pricing, format feasibility\n        │\n        ▼\nprint interior ──► PDF structural and folio checks\n        │\n        ▼\ncover geometry\u002Fart ──► cover safe-area and legibility checks\n        │\n        ▼\nreflowable EPUB ──► EPUB structure, navigation, links, and ZIP checks\n        │\n        ▼\nall-page rendering ──► contact sheets and human visual review\n        │\n        ▼\nrelease manifest ──► author approval and distribution handoff\n```\n\nWhen a title has more than one print interior, make the format matrix part of\nthe book configuration before building:\n\n```text\nlocked source\n   ├── standard interior ──► paperback cover geometry\n   └── compact hardcover interior ──► hardcover cover geometry\n   └── EPUB ──► ebook cover\n```\n\nEach interior is a format variant of the same source, never a manually edited\ncopy. The release manifest must record each variant's PDF path, page count,\nhash, render report, and configured page-limit policy. A cover spine must read\nthe page count from the matching final interior; using the standard PDF's page\ncount for a compact hardcover is a release defect.\n\nThe order is load-bearing. A cover cannot know its print spine until the PDF\npage count is final. An EPUB cannot embed its cover until the cover exists. A\ntable of contents cannot be trusted until typesetting has settled. A visual\nreview cannot be attached to the release until the exact artifact has been\nrendered. Never parallelize these steps merely because the tools are available.\n\n## Gate 0: source and manuscript audit\n\nBefore invoking a TeX engine, audit the source of record. The audit should:\n\n- load the one book configuration and verify that every Markdown file is\n  printed, deliberately excluded, or reported as an error;\n- reject missing, duplicate, empty, or untitled entries;\n- count words by front matter, numbered chapter, and back matter, with the\n  counting basis stated in the report;\n- enforce the target, hard floor, chapter count, shortest-chapter floor, and\n  permitted chapter-imbalance ratio declared by the author;\n- verify that required research method, source guide, evidence, objections,\n  institutional, and bibliography pieces are present and carry their actual\n  reader-facing titles;\n- reject unfinished markers and high-confidence planning language such as\n  “Evidence packet:” or “Case study:” when those phrases are not part of the\n  book's intended prose;\n- require numbered chapter openings to begin with an uppercase letter when the\n  print design uses a drop cap, and report later lowercase paragraph openings as\n  editorial warnings unless the book opts into a stricter gate;\n- count repeated rhetorical formulas so the sentence-level pass can see when a\n  useful contrast has become a template;\n- distinguish hard failures from warnings and preserve both in JSON.\n\nA word-count target is not permission to pad. If the target is missed, the\nreport should identify the gap and the shortest chapters so the next pass adds\nevidence, mechanism, case study, objection, or theological development. The\nquality gate must not reward repeated claims that add no new knowledge.\n\n## Gate 0.5: release-readiness contract\n\nBefore spending time on typesetting, verify the commercial and evidentiary\ninputs that were previously likely to live in a spreadsheet, a launch note, or\nthe operator's memory. The book configuration is the source of record. A\nrelease contract should declare and the native publisher command should measure:\n\n- title, subtitle, author, description, and the description's minimum useful\n  length;\n- the exact store-keyword count required by the target retailer, with unique,\n  non-empty keywords and no accidental duplication;\n- the required research apparatus files and a minimum count of reader-facing\n  source URLs, so a researched book cannot pass after its evidence register was\n  omitted from the build;\n- the date, source URL, currency, list prices, royalty assumptions, delivery\n  costs, and print-cost assumptions used for the pricing decision;\n- estimated unit economics for every configured format, reported as evidence\n  rather than treated as a promise of retailer payout;\n- page-count and trim constraints for each retailer and format. If a book\n  exceeds a platform limit, the contract must disable that format for that\n  platform or name the external provider and variant that will carry it.\n\nThe gate must fail on missing metadata, an invalid keyword cardinality, missing\nresearch apparatus, absent or stale pricing verification, impossible prices,\nor a configured format whose page count cannot be accepted by its retailer. It\nmay warn on a deliberate alternative such as an external hardcover provider,\nbut that warning must be explicit in the machine-readable report. The report\nmust be written beside the other release evidence before the build continues.\n\nThis gate is intentionally separate from human approval. A machine can prove\nthat seven keywords exist, that a pricing source was checked on a stated date,\nand that a 607-page interior exceeds a 550-page KDP hardcover limit. It cannot\ndecide whether the positioning is honest, whether the price is wise, or whether\nthe final cover deserves approval. Those remain recorded human judgments.\n\n## Gate 1: deterministic print build\n\nBuild the print interior from the audited source and run the checks against the\nfinished PDF, not only against the generated TeX. At minimum measure:\n\n- trim size, page count, embedded fonts, annotations, links, transparency,\n  margins, gutter rule, and overfull boxes;\n- printed folios and every contents entry, including back matter and the author\n  page;\n- absence of unfinished markers, forbidden dash characters, stale edition\n  labels, and development\u002Fproof language;\n- chapter numbering and the deliberate distinction between numbered narrative\n  chapters and unnumbered scholarly back matter;\n- the copyright edition line and configured metadata.\n\nIf the build produces a PDF with a different page count after a content change,\nthe old cover and any page-numbered contents evidence are stale. Do not repair\nthe old artifact by hand. Rebuild the dependent steps.\n\nUse `SOURCE_DATE_EPOCH` or an equivalent stable metadata strategy where the\ntoolchain supports it. Rebuilding unchanged source should not create a binary\ndiff merely because a clock moved.\n\n## Gate 2: covers from the final interior\n\nGenerate the ebook front cover and print wraps only after every configured\ninterior page count is final. The cover gate should verify:\n\n- exact ebook, paperback, and hardcover dimensions from the configured trim,\n  paper, bleed, board, hinge, and spine rules;\n- barcode clearance, text-safe areas, minimum print type size, and panel\n  boundaries;\n- title\u002Fauthor metadata agreement with the interior;\n- each print spine is calculated from its matching format variant, including a\n  hardcover page-limit check before artwork is accepted;\n- readable typography over artwork at the actual cover scale;\n- deterministic artwork from a declared seed and bundled fonts\u002Fassets;\n- the presence of every required upload file, including one-page wrap PDFs.\n\nThe script can prove geometry and pixel placement. It cannot prove that the\ncover is sexy, beautiful, or appropriate to the book. Produce a front-cover\npreview and a print-wrap preview as a review surface, then record the human\ndecision in the release manifest.\n\n## Gate 3: EPUB build and validation\n\nBuild the EPUB only after the cover exists. Validate both the package and the\nreading experience:\n\n- `mimetype` is first and uncompressed;\n- XML\u002FXHTML\u002FOPF\u002FNCX are well formed and contain no forbidden entity tricks;\n- the visible contents page, EPUB 3 navigation document, and NCX agree on\n  labels, nesting, and targets;\n- each contents link lands on the heading element that survives conversion;\n- the contents landmark points to the visible contents page, while the body\n  matter landmark starts the reading order;\n- internal links resolve and no stylesheet hides a contents target;\n- the cover is an RGB JPEG of the configured minimum size and is declared as\n  the package cover without an extra HTML cover page;\n- empty paragraphs, empty titles, stale proof language, straight quotes, and\n  unfinished markers are absent;\n- `epubcheck` runs when installed; if unavailable, the report says so rather\n  than implying that the built-in checks are the same thing;\n- the final ZIP passes a byte-level integrity test.\n\nThe EPUB 3 navigation specification and [EPUBCheck](https:\u002F\u002Fgithub.com\u002Fw3c\u002Fepubcheck)\nare external validation references. Store-specific converters are additional\nacceptance environments, not substitutes for a valid EPUB package; test them\nwhen the target retailer supplies a converter or previewer.\n\n## Gate 4: all-page visual evidence\n\nRender every PDF page at a declared DPI. Do not render only the page that was\nreported in a conversation: typography failures migrate when pagination\nchanges. The renderer should:\n\n- produce one numbered PNG per physical page and fail if the count differs;\n- assemble contact sheets with visible page labels and a stable order;\n- record dimensions, file sizes, blank pages, and overlong blank runs;\n- preserve the individual pages for close inspection of drop caps, chapter\n  openers, folios, contents, bibliography, tables, cover previews, and any\n  previously repaired page;\n- distinguish intentional structural blank pages from an unexpected run,\n  using the same rule as the print validator;\n- write the render report beside the release report.\n\nThe render report proves coverage, not taste. A human must still inspect the\ncontact sheets and sample pages at reading scale. The human review should be a\nrecorded decision with the report's artifact hash, not an untraceable “looked\ngood” in chat.\n\n## Gate 5: release manifest\n\nWrite one machine-readable manifest for the exact release attempt. A minimal\nmanifest contains:\n\n```json\n{\n  \"schema_version\": 1,\n  \"source\": {\"git_commit\": \"...\", \"config\": \"books\u002Fexample.toml\"},\n  \"manuscript\": {\"word_count\": 0, \"chapters\": 0, \"warnings\": []},\n  \"steps\": [{\"name\": \"pdf\", \"status\": \"pass\", \"command\": []}],\n  \"artifacts\": [\n    {\"kind\": \"pdf-interior\", \"path\": \"output\u002Fexample.pdf\", \"sha256\": \"...\"},\n    {\"kind\": \"epub\", \"path\": \"output\u002Fexample.epub\", \"sha256\": \"...\"}\n  ],\n  \"visual_qa\": {\"page_count\": 0, \"rendered_pages\": 0, \"contact_sheets\": []},\n  \"human_review\": {\"status\": \"pending\", \"reviewer\": null, \"notes\": []}\n}\n```\n\nThe manifest is not a marketing document. It is a chain of custody. If the\nbranch changes, a merge conflict is resolved, or any source file changes after\nthe report, the old manifest is evidence for the old release attempt and must\nnot be reused. Rerun the complete graph and issue a new manifest.\n\n## Retrospective lessons made executable\n\nThe following failure patterns are release regressions and should remain\ncovered by tests:\n\n| Manual discovery | Durable gate |\n| --- | --- |\n| A page-specific lowercase opening broke a drop cap | audit every numbered chapter opening |\n| A fragment such as “retrieval.” reached a printed page | configurable paragraph-start lint |\n| Planning packets appeared as prose | forbidden scaffold phrases and markers |\n| Back matter changed from a research apparatus to a bibliography | required actual back-matter titles |\n| Numbered chapters and scholarly back matter became mixed | source model and PDF\u002FEPUB ToC checks |\n| Cover text disappeared into artwork | cover safe-area, pixel, and preview checks |\n| A PDF page count changed the spine | PDF → cover dependency order |\n| A compact hardcover used the paperback page count | format matrix and per-variant spine input |\n| EPUB was refreshed manually after a merge | one release command plus deterministic timestamps |\n| Every page was “checked” from memory | page-counted renders, contact sheets, and report |\n| A build passed without `epubcheck` | explicit unavailable-tool status |\n| Store metadata and pricing were decided in a launch conversation | release-readiness contract with metadata, keyword, research, dated-source, and unit-economics checks |\n| A long book was priced as a hardcover without checking the retailer limit | page-count feasibility gate and explicit external-provider or split-edition decision |\n| Every book's PDF build failed in CI for several merges, because the runner's TeX packaging omitted a font the author's machine had | interior fonts vendored with their licences and loaded by path; one set of font files decides line breaks and page counts |\n| The release workflow had been red on every push and nobody had looked at the run history | read the workflow's recent runs before adding a gate; a red check is a finding, not background |\n| Unit tests existed and CI never ran them | tests run as the first workflow step, before the heavy build |\n\nThese gates do not eliminate editing. They make editing honest: the machine\nhandles inventory, measurement, conversion, and evidence; the author handles\nmeaning, beauty, historical judgment, and the final decision to put a name on\nthe work.\n\n## Operating procedure\n\n1. Lock the manuscript and configuration; do not begin from an old output file.\n2. Run the source audit and resolve every hard failure. Read warnings as a\n   revision queue, not as decoration.\n3. Run the release-readiness contract and resolve every hard failure or record\n   the explicit platform\u002Fformat exception.\n4. Build PDF, cover, and EPUB in dependency order.\n5. Render every page and inspect the contact sheets and representative full-size\n   pages. Record human review.\n6. Run the external retailer\u002Fpreviewer checks available for the intended format.\n7. Write the manifest, compare artifact hashes to the reviewed files, and only\n   then prepare the distribution handoff.\n8. If a conflict, content edit, metadata edit, page repair, or cover repair\n   occurs, invalidate the old manifest and rerun from Gate 0.\n\nFor repositories with a native command, use that command rather than copying\nthis sequence into a shell. In engineering-influence the canonical entry point\nis `scripts\u002Fpublish_book.py`; the skill supplies the method, while the\nrepository owns the implementation details and thresholds.\n\n## References\n\n- [EPUB 3.3](https:\u002F\u002Fwww.w3.org\u002FTR\u002Fepub-33\u002F) — package, navigation, and reading-order requirements.\n- [EPUBCheck](https:\u002F\u002Fgithub.com\u002Fw3c\u002Fepubcheck) — reference EPUB conformance validator.\n- [SOURCE_DATE_EPOCH](https:\u002F\u002Freproducible-builds.org\u002Fdocs\u002Fsource-date-epoch\u002F) — reproducible-build timestamp convention.\n- [Content Engineering Pipeline: Book Production](..\u002Fpipeline-book-production\u002FSKILL.md) — Phase 4 assembly and Phase 5 revision gates that precede this release layer.\n","# Book Release Engineering\n\nBook production is a software delivery problem with a human editorial\nacceptance layer. A manuscript is source code, a book configuration is a build\nmanifest, the PDF\u002FEPUB\u002Fcovers are compiled artifacts, and the release report is\nthe evidence that the artifacts came from the intended source and passed the\ndeclared gates. The analogy is useful only if it preserves the difference:\ntypesetting can be deterministic while literary judgment remains human.\n\nThis skill is the reusable release layer for the Content Engineering Pipeline's\nPhases 4–5. It closes the gap between a publication method that describes what\nshould be checked and a repository that can prove what was checked. Use it\nafter the manuscript's structural, argument, consistency, voice, evidence, and\nplaceholder passes are complete, and before any store submission or public\ndistribution.\n\n## The governing rule: no invisible manual state\n\nIf a future release depends on a command someone remembers, a page someone\nlooked at once, a word count someone calculated in a one-off shell expression,\nor a cover decision that exists only in chat history, the process is not yet\nengineered. Convert that decision into one of four durable forms:\n\n1. **Source configuration** — a machine-readable threshold, ordering rule,\n   required apparatus list, or exception with a named reason.\n2. **Executable gate** — a check that fails with a path, line, artifact, or\n   measured value rather than a vague assertion.\n3. **Review surface** — a rendered page, contact sheet, EPUB inspection set,\n   or report that lets a human make the remaining judgment quickly.\n4. **Evidence record** — a versioned JSON manifest containing the source\n   revision, commands, tool versions, hashes, counts, warnings, and decisions.\n\nDo not turn a judgment into a fake Boolean merely to make a dashboard green.\nRecord it as an explicit human decision attached to the evidence bundle.\n\n## Release graph\n\nThe release command must own this dependency graph:\n\n```text\nsource inventory and prose audit\n        │\n        ▼\nrelease-readiness contract ──► metadata, research, pricing, format feasibility\n        │\n        ▼\nprint interior ──► PDF structural and folio checks\n        │\n        ▼\ncover geometry\u002Fart ──► cover safe-area and legibility checks\n        │\n        ▼\nreflowable EPUB ──► EPUB structure, navigation, links, and ZIP checks\n        │\n        ▼\nall-page rendering ──► contact sheets and human visual review\n        │\n        ▼\nrelease manifest ──► author approval and distribution handoff\n```\n\nWhen a title has more than one print interior, make the format matrix part of\nthe book configuration before building:\n\n```text\nlocked source\n   ├── standard interior ──► paperback cover geometry\n   └── compact hardcover interior ──► hardcover cover geometry\n   └── EPUB ──► ebook cover\n```\n\nEach interior is a format variant of the same source, never a manually edited\ncopy. The release manifest must record each variant's PDF path, page count,\nhash, render report, and configured page-limit policy. A cover spine must read\nthe page count from the matching final interior; using the standard PDF's page\ncount for a compact hardcover is a release defect.\n\nThe order is load-bearing. A cover cannot know its print spine until the PDF\npage count is final. An EPUB cannot embed its cover until the cover exists. A\ntable of contents cannot be trusted until typesetting has settled. A visual\nreview cannot be attached to the release until the exact artifact has been\nrendered. Never parallelize these steps merely because the tools are available.\n\n## Gate 0: source and manuscript audit\n\nBefore invoking a TeX engine, audit the source of record. The audit should:\n\n- load the one book configuration and verify that every Markdown file is\n  printed, deliberately excluded, or reported as an error;\n- reject missing, duplicate, empty, or untitled entries;\n- count words by front matter, numbered chapter, and back matter, with the\n  counting basis stated in the report;\n- enforce the target, hard floor, chapter count, shortest-chapter floor, and\n  permitted chapter-imbalance ratio declared by the author;\n- verify that required research method, source guide, evidence, objections,\n  institutional, and bibliography pieces are present and carry their actual\n  reader-facing titles;\n- reject unfinished markers and high-confidence planning language such as\n  “Evidence packet:” or “Case study:” when those phrases are not part of the\n  book's intended prose;\n- require numbered chapter openings to begin with an uppercase letter when the\n  print design uses a drop cap, and report later lowercase paragraph openings as\n  editorial warnings unless the book opts into a stricter gate;\n- count repeated rhetorical formulas so the sentence-level pass can see when a\n  useful contrast has become a template;\n- distinguish hard failures from warnings and preserve both in JSON.\n\nA word-count target is not permission to pad. If the target is missed, the\nreport should identify the gap and the shortest chapters so the next pass adds\nevidence, mechanism, case study, objection, or theological development. The\nquality gate must not reward repeated claims that add no new knowledge.\n\n## Gate 0.5: release-readiness contract\n\nBefore spending time on typesetting, verify the commercial and evidentiary\ninputs that were previously likely to live in a spreadsheet, a launch note, or\nthe operator's memory. The book configuration is the source of record. A\nrelease contract should declare and the native publisher command should measure:\n\n- title, subtitle, author, description, and the description's minimum useful\n  length;\n- the exact store-keyword count required by the target retailer, with unique,\n  non-empty keywords and no accidental duplication;\n- the required research apparatus files and a minimum count of reader-facing\n  source URLs, so a researched book cannot pass after its evidence register was\n  omitted from the build;\n- the date, source URL, currency, list prices, royalty assumptions, delivery\n  costs, and print-cost assumptions used for the pricing decision;\n- estimated unit economics for every configured format, reported as evidence\n  rather than treated as a promise of retailer payout;\n- page-count and trim constraints for each retailer and format. If a book\n  exceeds a platform limit, the contract must disable that format for that\n  platform or name the external provider and variant that will carry it.\n\nThe gate must fail on missing metadata, an invalid keyword cardinality, missing\nresearch apparatus, absent or stale pricing verification, impossible prices,\nor a configured format whose page count cannot be accepted by its retailer. It\nmay warn on a deliberate alternative such as an external hardcover provider,\nbut that warning must be explicit in the machine-readable report. The report\nmust be written beside the other release evidence before the build continues.\n\nThis gate is intentionally separate from human approval. A machine can prove\nthat seven keywords exist, that a pricing source was checked on a stated date,\nand that a 607-page interior exceeds a 550-page KDP hardcover limit. It cannot\ndecide whether the positioning is honest, whether the price is wise, or whether\nthe final cover deserves approval. Those remain recorded human judgments.\n\n## Gate 1: deterministic print build\n\nBuild the print interior from the audited source and run the checks against the\nfinished PDF, not only against the generated TeX. At minimum measure:\n\n- trim size, page count, embedded fonts, annotations, links, transparency,\n  margins, gutter rule, and overfull boxes;\n- printed folios and every contents entry, including back matter and the author\n  page;\n- absence of unfinished markers, forbidden dash characters, stale edition\n  labels, and development\u002Fproof language;\n- chapter numbering and the deliberate distinction between numbered narrative\n  chapters and unnumbered scholarly back matter;\n- the copyright edition line and configured metadata.\n\nIf the build produces a PDF with a different page count after a content change,\nthe old cover and any page-numbered contents evidence are stale. Do not repair\nthe old artifact by hand. Rebuild the dependent steps.\n\nUse `SOURCE_DATE_EPOCH` or an equivalent stable metadata strategy where the\ntoolchain supports it. Rebuilding unchanged source should not create a binary\ndiff merely because a clock moved.\n\n## Gate 2: covers from the final interior\n\nGenerate the ebook front cover and print wraps only after every configured\ninterior page count is final. The cover gate should verify:\n\n- exact ebook, paperback, and hardcover dimensions from the configured trim,\n  paper, bleed, board, hinge, and spine rules;\n- barcode clearance, text-safe areas, minimum print type size, and panel\n  boundaries;\n- title\u002Fauthor metadata agreement with the interior;\n- each print spine is calculated from its matching format variant, including a\n  hardcover page-limit check before artwork is accepted;\n- readable typography over artwork at the actual cover scale;\n- deterministic artwork from a declared seed and bundled fonts\u002Fassets;\n- the presence of every required upload file, including one-page wrap PDFs.\n\nThe script can prove geometry and pixel placement. It cannot prove that the\ncover is sexy, beautiful, or appropriate to the book. Produce a front-cover\npreview and a print-wrap preview as a review surface, then record the human\ndecision in the release manifest.\n\n## Gate 3: EPUB build and validation\n\nBuild the EPUB only after the cover exists. Validate both the package and the\nreading experience:\n\n- `mimetype` is first and uncompressed;\n- XML\u002FXHTML\u002FOPF\u002FNCX are well formed and contain no forbidden entity tricks;\n- the visible contents page, EPUB 3 navigation document, and NCX agree on\n  labels, nesting, and targets;\n- each contents link lands on the heading element that survives conversion;\n- the contents landmark points to the visible contents page, while the body\n  matter landmark starts the reading order;\n- internal links resolve and no stylesheet hides a contents target;\n- the cover is an RGB JPEG of the configured minimum size and is declared as\n  the package cover without an extra HTML cover page;\n- empty paragraphs, empty titles, stale proof language, straight quotes, and\n  unfinished markers are absent;\n- `epubcheck` runs when installed; if unavailable, the report says so rather\n  than implying that the built-in checks are the same thing;\n- the final ZIP passes a byte-level integrity test.\n\nThe EPUB 3 navigation specification and [EPUBCheck](https:\u002F\u002Fgithub.com\u002Fw3c\u002Fepubcheck)\nare external validation references. Store-specific converters are additional\nacceptance environments, not substitutes for a valid EPUB package; test them\nwhen the target retailer supplies a converter or previewer.\n\n## Gate 4: all-page visual evidence\n\nRender every PDF page at a declared DPI. Do not render only the page that was\nreported in a conversation: typography failures migrate when pagination\nchanges. The renderer should:\n\n- produce one numbered PNG per physical page and fail if the count differs;\n- assemble contact sheets with visible page labels and a stable order;\n- record dimensions, file sizes, blank pages, and overlong blank runs;\n- preserve the individual pages for close inspection of drop caps, chapter\n  openers, folios, contents, bibliography, tables, cover previews, and any\n  previously repaired page;\n- distinguish intentional structural blank pages from an unexpected run,\n  using the same rule as the print validator;\n- write the render report beside the release report.\n\nThe render report proves coverage, not taste. A human must still inspect the\ncontact sheets and sample pages at reading scale. The human review should be a\nrecorded decision with the report's artifact hash, not an untraceable “looked\ngood” in chat.\n\n## Gate 5: release manifest\n\nWrite one machine-readable manifest for the exact release attempt. A minimal\nmanifest contains:\n\n```json\n{\n  \"schema_version\": 1,\n  \"source\": {\"git_commit\": \"...\", \"config\": \"books\u002Fexample.toml\"},\n  \"manuscript\": {\"word_count\": 0, \"chapters\": 0, \"warnings\": []},\n  \"steps\": [{\"name\": \"pdf\", \"status\": \"pass\", \"command\": []}],\n  \"artifacts\": [\n    {\"kind\": \"pdf-interior\", \"path\": \"output\u002Fexample.pdf\", \"sha256\": \"...\"},\n    {\"kind\": \"epub\", \"path\": \"output\u002Fexample.epub\", \"sha256\": \"...\"}\n  ],\n  \"visual_qa\": {\"page_count\": 0, \"rendered_pages\": 0, \"contact_sheets\": []},\n  \"human_review\": {\"status\": \"pending\", \"reviewer\": null, \"notes\": []}\n}\n```\n\nThe manifest is not a marketing document. It is a chain of custody. If the\nbranch changes, a merge conflict is resolved, or any source file changes after\nthe report, the old manifest is evidence for the old release attempt and must\nnot be reused. Rerun the complete graph and issue a new manifest.\n\n## Retrospective lessons made executable\n\nThe following failure patterns are release regressions and should remain\ncovered by tests:\n\n| Manual discovery | Durable gate |\n| --- | --- |\n| A page-specific lowercase opening broke a drop cap | audit every numbered chapter opening |\n| A fragment such as “retrieval.” reached a printed page | configurable paragraph-start lint |\n| Planning packets appeared as prose | forbidden scaffold phrases and markers |\n| Back matter changed from a research apparatus to a bibliography | required actual back-matter titles |\n| Numbered chapters and scholarly back matter became mixed | source model and PDF\u002FEPUB ToC checks |\n| Cover text disappeared into artwork | cover safe-area, pixel, and preview checks |\n| A PDF page count changed the spine | PDF → cover dependency order |\n| A compact hardcover used the paperback page count | format matrix and per-variant spine input |\n| EPUB was refreshed manually after a merge | one release command plus deterministic timestamps |\n| Every page was “checked” from memory | page-counted renders, contact sheets, and report |\n| A build passed without `epubcheck` | explicit unavailable-tool status |\n| Store metadata and pricing were decided in a launch conversation | release-readiness contract with metadata, keyword, research, dated-source, and unit-economics checks |\n| A long book was priced as a hardcover without checking the retailer limit | page-count feasibility gate and explicit external-provider or split-edition decision |\n| Every book's PDF build failed in CI for several merges, because the runner's TeX packaging omitted a font the author's machine had | interior fonts vendored with their licences and loaded by path; one set of font files decides line breaks and page counts |\n| The release workflow had been red on every push and nobody had looked at the run history | read the workflow's recent runs before adding a gate; a red check is a finding, not background |\n| Unit tests existed and CI never ran them | tests run as the first workflow step, before the heavy build |\n\nThese gates do not eliminate editing. They make editing honest: the machine\nhandles inventory, measurement, conversion, and evidence; the author handles\nmeaning, beauty, historical judgment, and the final decision to put a name on\nthe work.\n\n## Operating procedure\n\n1. Lock the manuscript and configuration; do not begin from an old output file.\n2. Run the source audit and resolve every hard failure. Read warnings as a\n   revision queue, not as decoration.\n3. Run the release-readiness contract and resolve every hard failure or record\n   the explicit platform\u002Fformat exception.\n4. Build PDF, cover, and EPUB in dependency order.\n5. Render every page and inspect the contact sheets and representative full-size\n   pages. Record human review.\n6. Run the external retailer\u002Fpreviewer checks available for the intended format.\n7. Write the manifest, compare artifact hashes to the reviewed files, and only\n   then prepare the distribution handoff.\n8. If a conflict, content edit, metadata edit, page repair, or cover repair\n   occurs, invalidate the old manifest and rerun from Gate 0.\n\nFor repositories with a native command, use that command rather than copying\nthis sequence into a shell. In engineering-influence the canonical entry point\nis `scripts\u002Fpublish_book.py`; the skill supplies the method, while the\nrepository owns the implementation details and thresholds.\n\n## References\n\n- [EPUB 3.3](https:\u002F\u002Fwww.w3.org\u002FTR\u002Fepub-33\u002F) — package, navigation, and reading-order requirements.\n- [EPUBCheck](https:\u002F\u002Fgithub.com\u002Fw3c\u002Fepubcheck) — reference EPUB conformance validator.\n- [SOURCE_DATE_EPOCH](https:\u002F\u002Freproducible-builds.org\u002Fdocs\u002Fsource-date-epoch\u002F) — reproducible-build timestamp convention.\n- [Content Engineering Pipeline: Book Production](..\u002Fpipeline-book-production\u002FSKILL.md) — Phase 4 assembly and Phase 5 revision gates that precede this release layer.\n",{"name":5,"description":7},"develop","ae32736a1aabddabca5d2c96d665aa0ebc7d8700","src\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fcontent-engineering-pipeline\u002Fskills\u002Fpipeline-book-release-engineering",3,"https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey","https:\u002F\u002Fthe-vibey-project.github.io\u002Fvibey\u002F","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project","https:\u002F\u002Fvibewithadam.matthewsteinberger.com","freedom for software engineers","2026-11-15 05:47:42",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add the-vibey-project\u002Fvibey --skill pipeline-book-release-engineering",{"tool":40,"command":41},"bunx","bunx skills add the-vibey-project\u002Fvibey --skill pipeline-book-release-engineering",{"tool":43,"command":44},"pnpm","pnpm dlx skills add the-vibey-project\u002Fvibey --skill pipeline-book-release-engineering","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fcontent-engineering-pipeline\u002Fskills\u002Fpipeline-book-release-engineering\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M7AT1FQJAE1FQYAMDTF490Y4","white-paper-writing","Use when writing white papers, technical reports, policy documents, thought leadership pieces, or any long-form authoritative document. Triggers on requests to write, structure, outline, or review white papers, technical reports, position papers, policy briefs, or evidence-driven arguments. Also use for B2B content marketing strategy, technical documentation requiring authority, academic-style reports, or any document that must educate while persuading. Use when someone asks \"how should I structure this\" for a long-form document.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fwhite-paper-writing\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M7AT16BJRJJKK2MASXRZS76G","prose-technical-mechanics","Use when editing or writing prose at a technical\u002Fmechanical level: choosing between Anglo-Saxon and Latinate diction, placing information in topic vs stress positions, writing periodic vs cumulative sentences, handling sentence rhythm, punctuation as logic, transitions, paragraph structure, or phonesthetics. Use when someone wants to understand WHY prose works or doesn't, not just surface-level style advice. Triggers on word choice, sentence structure, emphasis, rhythm, diction, or any deep writing mechanics question.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-technical-mechanics\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M7AT0W9HT0ZZ9Y287NW99MR3","prose-mechanics","Use when writing, editing, or analyzing prose style; when trying to avoid generic AI-sounding writing; when applying specific prose styles such as journalistic, academic, narrative, KJV biblical, Hemingway plain, Latinate\u002FJamesian, Orwellian, Augustan, Victorian, Early Modern (Bacon, Browne, Milton), or free indirect discourse; or when coaching someone on writing voice and mechanics. Triggers on any request to improve, analyze, or write in a specific prose style, to fix \"AI-sounding\" writing, to make prose more vivid or concrete, to vary sentence rhythm, or to understand how a particular writer achieves their effects.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fprose-mechanics\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7AT0KR635JX66X2X6F3E2CP","narrative-structure","Use when structuring stories, pitches, presentations, white papers, or any persuasive narrative; analyzing the hero's journey in fiction or non-fiction; applying StoryBrand for business communication; designing narrative arcs for thought leadership; or understanding Vogler, Snyder, Propp, or Campbell frameworks. Triggers on any narrative structure, storytelling, pitch structure, StoryBrand, hero's journey, three-act structure, Freytag, Save the Cat, narrative arc, or \"how should I structure this story\u002Fpitch\u002Fpresentation\" request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fnarrative-structure\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M7AT0AKGW09NKKZDYBT8VRDE","legal-brief-writing","Use when writing legal briefs, motions, or any court filing; when analyzing judicial cognition and persuasion; when applying elite brief-writing techniques from Roberts, Clement, Kagan, Garner; or when structuring legal arguments for maximum persuasion. Also use for autistic\u002Fneurodivergent advocates who need to understand how their natural communication style maps to elite legal advocacy. Triggers on any legal writing, brief drafting, motion preparation, or legal argument structuring request.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Flegal-brief-writing\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M7AT00VWPS4Q8B5VEMXX9NQT","journal-publishability-criteria","Use whenever a research paper, article or preprint is being written, revised, reviewed or published, and specifically before every publication of docs\u002Fpaper.md. Covers what legitimate journals actually gate on, in order of gating — the editor's desk screen (scope, novelty, package problems), what reviewers judge (methodological soundness, claims the evidence can carry, statistical and qualitative reporting), EQUATOR reporting guidelines, the ICMJE authorship criteria, COPE's view of text recycling, the near-universal generative-AI policy (no AI author, disclosure, author responsibility), TOP 2025 transparency standards, how to verify a journal is legitimate, submitting without an institution, and a pre-submission checklist. Triggers on requests to evaluate, review, prepare or submit a paper, to judge publishability, to write a declarations or data-availability section, to disclose AI use, or to check a journal.","https:\u002F\u002Fgithub.com\u002Fthe-vibey-project\u002Fvibey\u002Fblob\u002Fdevelop\u002Fsrc\u002Fvibey_tools\u002Fskills\u002Fplugins\u002Fwriting-craft\u002Fskills\u002Fjournal-publishability-criteria\u002FSKILL.md",[],[]]