# Bilingual Reader Maker

> Use when the user asks to make bilingual reading materials, bilingual PDFs, Chinese-English study editions, mobile-readable HTML/PDF readers, or to turn an English PDF/article into a polished bilingual reader.

- **Type:** Skill
- **Install:** `agentstack add skill-philrobinluo-ai-coevolution-skills-bilingual-reader-maker`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [PhilRobinluo](https://agentstack.voostack.com/s/philrobinluo)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [PhilRobinluo](https://github.com/PhilRobinluo)
- **Source:** https://github.com/PhilRobinluo/ai-coevolution-skills/tree/main/skills/bilingual-reader-maker

## Install

```sh
agentstack add skill-philrobinluo-ai-coevolution-skills-bilingual-reader-maker
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```text
//
├── 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:

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

For Chinese-facing editions:

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

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`.

2. 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.

3. 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.

4. 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.

5. 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:

```bash
"/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:

```bash
"/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](https://github.com/PhilRobinluo)
- **Source:** [PhilRobinluo/ai-coevolution-skills](https://github.com/PhilRobinluo/ai-coevolution-skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-philrobinluo-ai-coevolution-skills-bilingual-reader-maker
- Seller: https://agentstack.voostack.com/s/philrobinluo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.