pdf-to-epub SKILL.md skillA

pdf-to-epub from coderperseus/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add coderperseus/skills/pdf-to-epub@git:20260819.72eb71c

Pins git:20260819.72eb71c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
coderperseus/skills
Path
skills/pdf-to-epub/SKILL.md
Versions recorded
1
Latest version
git:20260819.72eb71c, committed Aug 19, 2026
Size
2,623 bytes
Repository stars
2
License
none declared

Convert a PDF book into a reflowable EPUB (strip running headers/footers/watermarks, rebuild paragraphs, split chapters). Use when the user asks to 转 EPUB / PDF 转电子书 / convert PDF to EPUB / Calibre 效果不好 / 扫描件转 EPUB, or runs /pdf-to-epub.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# pdf-to-epub

Turn a PDF book into a reflowable EPUB. Prefer the bundled converter over Calibre for Chinese/English **text-layer** books. Do not hardcode page maps or book-specific regexes — the script is the converter.

## When to use

- "把这本 PDF 转成 EPUB"
- "PDF 转电子书 / convert this PDF to EPUB"
- "Calibre 转完断行/页眉很乱"
- Explicit `/pdf-to-epub`

Do **not** use for: PDF form filling, merging PDFs, Markdown→EPUB, or "turn this book into a study skill".

## Convert

Resolve `scripts/pdf_to_epub.py` from this skill directory (the folder that contains this `SKILL.md`).

```bash
python3 -m pip install -r requirements.txt
python3 scripts/pdf_to_epub.py "/path/to/book.pdf" -o "/path/to/book.epub"
```

Optional: `--title` `--author` (repeatable) `--inspect` (JSON plan, no write).

The script prints JSON: `text_ratio`, `chapter_source` (`bookmarks` | `running-headers` | `single`), chapter titles, output path.

## Decision tree

1. Locate the PDF. Default EPUB path: same directory, `.epub` suffix.
2. Run the converter (or `--inspect` first on huge/unknown files).
3. **Exit 0** — report the EPUB path, chapter count, and `chapter_source`. Do not open-and-review unless the user asks.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add coderperseus/skills/pdf-to-epub@sha256:1f9f59df4d6186cb

The line at the top of this page pins the label git:20260819.72eb71c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vpuqxgrrrhobwi4x.svg)](https://markdownregistry.com/a/art_vpuqxgrrrhobwi4x)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Aug 19, 2026.

versioncommittedcommitsizeaudit
git:20260819.72eb71c latest2026-08-19 72eb71c 2,623 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2623 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

coderperseus/skills · 2 stars · license none declared · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vpuqxgrrrhobwi4x
GET https://markdownregistry.com/api/v1/resolve?ref=coderperseus/skills/pdf-to-epub
GET https://markdownregistry.com/api/v1/blob/1f9f59df4d6186cbda2113d54e663d12aeb623d1b1dbd3790e73e8320c8c07d6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from coderperseus/skills

polish-spoken-video SKILL.md skill
coderperseus/skills · polish-spoken-video/SKILL.md · 精修用户提供的口播、录屏讲解或实测视频,去除卡顿、重说和无意义空白,保留必要演示,添加低存在感的浅灰圆角底字幕,直接交付成片。用户说“按上次标准剪口播”“柔和灰底字幕”“不用确认直接剪”时使用;不用于从零生成视频。
git:20261020.5b402d5 · audit A · 2 stars
bug-hunt SKILL.md skill
coderperseus/skills · skills/bug-hunt/SKILL.md · Systematic root-cause debugging for software bugs (frontend, backend, mobile). Use when the user reports a symptom that…
git:20260525.95477a8 · audit A · 2 stars
mygo-intro-animation SKILL.md skill
coderperseus/skills · skills/mygo-intro-animation/SKILL.md · Build a first-run / install intro animation ("安装动画", "开场动画", "首次启动动画", onboarding intro) for a myGo native-UI macOS app…
git:20261028.1b4899a · audit A · 2 stars
seo-geo-playbook SKILL.md skill
coderperseus/skills · skills/seo-geo-playbook/SKILL.md · Audit, design, implement, and verify production-grade Technical SEO and Generative Engine Optimization (GEO / AI Search…
git:20261028.3ec2fc2 · audit B · 2 stars
surger SKILL.md skill
coderperseus/skills · skills/surger/SKILL.md · Diagnose and operate Surge for Mac through terminal-first workflows. Use when the user asks about Surge, surge-cli…
git:20260625.72f8a78 · audit B · 2 stars

Every file in coderperseus/skills

Browse by kind, by grade A, or by owner.