Bilingual Reader Maker

Bilingual Reader Maker

Produce polished bilingual reading materials from English source PDFs or long articles.

Default output:

• Real-text HTML for editing, copying, searching, parsing, and mobile reading.
• PDF exported from that HTML for sharing.
• English source paragraph first, Simplified Chinese translation immediately below.

Workspace

Create one project folder per source:

//
├── source/          # source PDF/article/assets, preserve originals
├── intermediate/    # extracted text, translation cache, page samples
├── output/          # final HTML/PDF and copied assets
├── qa/              # screenshots/thumbnails/render checks
└── scripts/         # project-specific generation scripts

If the user already has a project folder, work inside it. Do not create duplicates.

Production Standard

• Preserve the source's visual identity where appropriate: cover, chapter art, color palette, logos, icons, and typographic mood.
• Do not force the original layout if it hurts learning. For phone-friendly reading, prefer normal single-column flow.
• Structure each reading unit as:

1. English source paragraph
2. Chinese translation
3. Light divider

• Use real text HTML, not a screenshot-only artifact.
• Export PDF from the HTML using Chrome headless when available.
• Add attribution only if the user wants it. Keep it subtle and place it in a final colophon, not on the cover.

Suggested colophon pattern:

This bilingual study edition was prepared for learning, reading, and discussion.
Prepared by: 

For Chinese-facing editions:

本中英双语学习版基于原英文材料整理制作，仅用于学习、阅读与交流。
整理制作：

Avoid aggressive calls to follow, QR codes, sales language, or cover branding unless explicitly requested.

Workflow

1. Bootstrap:

• Locate source file(s) and project folder.
• Preserve the original source file.
• Check for local project instructions such as AGENTS.md or CLAUDE.md.

1. Extract and inspect:

• Extract text with pypdf first.
• If text extraction is poor, render pages and consider OCR.
• Render representative original pages into qa/original/ to inspect real colors, cover, chapter art, icons, and layout.

1. Translate:

• Translate by coherent paragraph/segment, not whole-page blobs.
• Preserve the English source text.
• Keep a translation cache in intermediate/translation_cache.json.
• Verify there are no missing translations, empty translations, or placeholder strings.

1. Design HTML:

• Use original visual assets for cover/chapter pages when possible and legally appropriate.
• Use single-column mobile-readable body layout by default.
• Use calm editorial typography: serif for English headings/body when it fits; readable Chinese fonts for translation.
• Keep the HTML source clear enough to modify later.

1. Export and QA:

• Export PDF from HTML.
• Capture screenshots for cover, table of contents, a chapter/section page, a body page, and one narrow mobile viewport.
• Check for horizontal overflow, clipped text, missing assets, old copy, missing translations, and unreadable density.
• Open/reveal final artifacts or provide direct paths/links.

Useful Commands

Chrome PDF export:

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless=new --disable-gpu --no-sandbox \
  --print-to-pdf="$PDF" --print-to-pdf-no-header "$HTML_URL"

Phone-width screenshot:

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless=new --disable-gpu --no-sandbox \
  --window-size=430,1200 --screenshot="$SHOT" "$HTML_URL"

Naming

Use descriptive output names:

• _bilingual-mobile-reader.html
• _bilingual-mobile-reader.pdf

For Chinese-facing editions:

• _中英双语移动阅读版.html
• _中英双语移动阅读版.pdf

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: PhilRobinluo
• Source: PhilRobinluo/ai-coevolution-skills
• License: MIT

Install and usage instructions live in the source repository linked above.