EPUB Golden Build Guide
A focused reference skill for testing EPUB golden builds and locating document concepts, APIs, examples, and troubleshooting notes.
The skill presents documentation indexes, code snippets, tables, and references only, with no evident malware, credential theft, or destructive behavior. However, it does not disclose data flow, sensitive-data handling, user confirmation, isolation, or rollback, and the Jane Doe/Acme Press attribution is not verifiable from the material, so points are deducted.
The SKILL.md and reference files are broadly consistent on sections, code blocks, tables, and statistics, and repository-level tests and CI provide supporting signals. However, a long code example is truncated, abnormal-input behavior and failure feedback are unspecified, and static review cannot establish execution, so points are deducted.
The trigger, “testing the epub golden build,” is relatively specific and fits a narrow test scenario. Inputs, outputs, non-fit boundaries, environment requirements, and semantic trigger limits are not stated; the content is English-only and gives no mainland-China reachability or Chinese-language guidance, so points are deducted.
The document includes front matter, a section overview, quick reference, examples, statistics, and reference navigation. Repository context supplies an MIT license, version metadata, and test configuration, but the skill itself lacks installation notes, dependency guidance, changelog/version policy, maintenance ownership, update path, and troubleshooting detail, so points are deducted.
It can serve as a small EPUB golden-document reference, and its reference file is directly readable. It does not perform the advertised conversion task, examples are largely toy content, one long example is truncated, and API and troubleshooting coverage are incomplete; practical value beyond reading the files directly is therefore limited.
The fixed-revision source files, references, and repository-level test and CI configuration provide limited auditability. There is no explicit test result for this skill's key paths, third-party execution evidence, or cross-source corroboration, so the conclusion remains primarily static and points are deducted.
- Do not treat this SKILL.md as an executable EPUB converter; it is primarily a golden fixture and generated documentation artifact.
- The truncated Python example, toy installation command, and generic API description may cause misuse; verify against the original EPUB and complete references before relying on it.
- There is no documented sensitive-data handling, external-network behavior, failure recovery, or rollback; confirm input scope and output locations before processing real documents.
- The content is English-only and does not establish suitability for Chinese-language use or mainland-China network conditions.
What it does & when to use it
This skill is intended for testing the EPUB golden build. It documents The Handbook, including its metadata, three-section structure, key topics, code examples, tables, and extraction statistics. Its coverage includes getting started guidance, API usage, and troubleshooting. It also points to handbook reference content and a complete navigation index.
Reports The Handbook's title, author, language, publisher, and date; summarizes its three sections and topics; indexes getting-started, API-usage, and troubleshooting material; presents Bash and Python examples with quality scores; reports counts for sections, code blocks, images, tables, and languages; and points to references/handbook.md and references/index.md.
- A developer testing an EPUB documentation or golden-build pipeline can use it to inspect extracted metadata and structure.
- A user looking for getting-started, API-usage, or troubleshooting material in The Handbook can use it as a quick reference.
- An engineer needing documented Python or Bash examples can consult the extracted snippets.
- A test author validating EPUB extraction can use the section, table, image, code-block, and language statistics as expected-output signals.
Pros & cons
- Clearly scoped to EPUB golden-build testing.
- Provides structured summaries of sections, topics, code, tables, and document statistics.
- Includes Bash and Python examples with quality scores.
- Supplies reference-file and navigation paths.
- The source does not document an EPUB input, build command, or test assertion.
- It covers only one example document, The Handbook.
- The longer Python example is truncated and is not directly usable as a complete implementation.
- No dedicated installation location or runtime dependency is documented.
How to install
Use the repository file at tests/golden/phase2/epub/SKILL.md as the skill definition. The source does not document a separate installation command or destination directory.
How to use
In an environment where the skill is available, ask to test the EPUB golden build or to locate concepts, API examples, and troubleshooting content from The Handbook. Consult references/index.md for the full structure and references/handbook.md for the handbook reference content.