菜单
Download Libby audiobooks (MP3/m4b, odmpy or Chrome CDP) and eBooks to PDF/EPUB (libby-dl pdf/ebook). Triggers on libby download, libby audiobook, libby ebook, libby pdf, odmpy libby, libby-dl.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Amend a published CLI from one of two input sources: (1) dogfood mode mines the active Claude Code session transcript for friction (missing flags, hand- rolled API payloads, silent-null returns); (2) direct-input mode accepts user-supplied asks (rename a command, add commands or feeds, fix a named bug, optionally sniff the source site for new endpoints). Confirms scope with the user, plans + executes the fix autonomously, scrubs PII, and opens a PR against mvanhorn/printing-press-library. Two user-in-loop checkpoints: scope after capture, PR draft before open. Trigger phrases: "amend the CLI", "submit a patch", "fix what I just dogfooded", "open a PR for this CLI", "patch this CLI", "add features to my CLI", "rename this command", "add these feeds to <cli>", "sniff for new APIs in <cli>", "amend with these ideas", "use printing-press-amend", "run printing-press-amend".
Bring a published CLI from the public library into the internal library so it's identical to a freshly-generated copy — module path reverted, manuscripts placed alongside, ready for /printing-press-polish or /printing-press-emboss. Use when the public library has a CLI you don't have locally, or to recover from a broken/lost internal copy. Trigger phrases: "import the CLI", "bring it into my library", "fetch from public library", "I don't have it locally yet".
Internal sub-skill: agentic review of a printed CLI's sampled command output for plausibility issues that rule-based checks can't encode (substring-match relevance, format bugs, silent source drops, ranking failures). Invoked via the Skill tool by main printing-press SKILL.md (Phase 4.85) and printing-press-polish SKILL.md during the diagnostic loop. Not for direct user invocation — its actionable wrappers are /printing-press and /printing-press-polish.
Polish a generated CLI to pass verification and become publish-ready. Runs diagnostics (dogfood, verify, scorecard, go vet, gosec), automatically fixes all issues (verify failures, static-analysis findings, dead code, descriptions, README, MCP tool quality), reports the before/after delta, and offers to publish. Use after any /printing-press run, or on any CLI in $PRESS_LIBRARY/. Trigger phrases: "polish", "improve the CLI", "fix verify", "make it publish-ready", "clean up the CLI", "get this ready to ship".
Regenerate an existing printed CLI from scratch under the current Printing Press, with prior research, prior novel features, and prior patches (post-publish hand-fixes) carried into the writing pipeline as reconciliation context rather than dropped on the floor. Pulls the CLI from the public library if it isn't local, recommends reuse-vs-redo of prior research based on age, then hands off to /printing-press with the right context. Use when a machine upgrade would benefit a published CLI more than manual polish. Trigger phrases: "reprint <api>", "regenerate <api>", "redo the <api> CLI", "rebuild <api> from scratch", "this CLI would benefit from a reprint".
Score a generated CLI against the Steinberger bar, compare two CLIs side-by-side
| name | libby-dl |
| description | Download Libby audiobooks (MP3/m4b, odmpy or Chrome CDP) and eBooks to PDF/EPUB (libby-dl pdf/ebook). Triggers on libby download, libby audiobook, libby ebook, libby pdf, odmpy libby, libby-dl. |
CLI: ~/tools/libby-cli — v1.6.1 — libby-dl on PATH (~/bin/libby-dl).
Before any download, the CLI runs ensureOdmpySetup on these commands:
| Command | Auto-setup |
|---|---|
run | Step 0 (always unless --skip-setup) |
download | Before odmpy (audiobook) |
ebook / pdf | Before odmpy (eBook) |
doctor | Before checks |
finish | Before odmpy |
setup | Explicit configure / --check |
Non-interactive agents (no TTY): auth will fail until the user provides an 8-digit Libby code:
libby-dl setup --code 12345678
# or any command with global flag:
libby-dl --code 12345678 run -d ~/Downloads/my-book --title-id 12519104
Libby app → ☰ Menu → Get setup code (8 digits, ~10 min expiry).
Token file (optional): ~/.config/libby-dl/libby-token or LIBBY_TOKEN env.
PartNN.mp3)| Step | Command | Notes |
|---|---|---|
| 0 | libby-dl setup --check or libby-dl setup --code … | Never skip unless odmpy already passes --check |
| 1 | Confirm format | Loan page has Listen / audiobook — not Read/eBook |
| 2 | libby-dl init -d DIR | If new download dir |
| 3 | libby-dl discover -d DIR | Debug-CDP Chrome (libby-dl chrome) → spine.json (skip if odmpy will run first and --from-files later) |
| 4 | libby-dl gate -d DIR | Loan active, Listen iframe, odmpy or CDP viable |
| 5 | libby-dl run -d DIR --title-id ID --loan-url URL | Preferred — auto setup → odmpy → gate → CDP gaps → merge/tag |
| 6 | libby-dl verify -d DIR | Exit 0 = all requiredParts full |
| 7 | Return Libby loan | Only after step 6 passes |
Partial recovery (loan still active): libby-dl plan -d DIR then libby-dl cdp --missing-only.
| Step | Command |
|---|---|
| 0 | libby-dl setup --code … (uses scripts/libby_setup.py + TLS patch) |
| 0b | libby-dl deps — install calibre + Adobe Digital Editions if missing |
| 1 | libby-dl hp or libby-dl pdf --title-id <id> -d DIR (PDF default for HP) |
| 1b | Pipeline: odmpy/Chrome .acsm → ADE → book.epub → calibre; on DRM → chrome_read_to_pdf.py (Libby reader screenshots) |
| 1c | Requires :9222 Chrome with Libby signed in; installs/repairs Calibre (brew reinstall --cask calibre if stub) |
Do not use run, cdp, discover, or verify for eBooks.
| Output | Meaning |
|---|---|
.pdf | Ready (open PDF or converted EPUB) |
.epub | Open EPUB — use as-is or brew install calibre for conversion |
.acsm | Adobe DRM — success for epub goal; open in Adobe Digital Editions → get .epub |
See ~/tools/libby-cli/docs/EBOOK.md.
libby-dl run -d ~/Downloads/libby-my-title-LOANID-TITLEID \
--title-id TITLEID \
--loan-url 'https://libbyapp.com/open/loan/LOANID/TITLEID'
Pipeline order inside run:
ensureOdmpySetup)verify would passUse --allow-partial only when the user explicitly accepts a partial archive.
spine.jsonSee ~/tools/libby-cli/docs/SPINE.md.
libby-dl discover -d DIR — Listen UI labels → spine.jsonlibby-dl discover -d DIR --from-files — after odmpylibby-dl verify — required parts ≥400KB; previews <200KB or label heuristics| Failure | Guard |
|---|---|
| No odmpy auth | Auto setup on run/download/doctor; fail with instructions if no TTY/code |
| Returned loan mid-CDP | gate + 403 blockers |
| Preview as chapter | spine.previewOnlyParts + byte thresholds |
| False FULL BOOK | tag / run require verify |
| eBook mistaken for audiobook | Check Listen vs Read on Libby page |
| Command | Purpose |
|---|---|
setup / setup --check | Configure or verify odmpy |
run | Full pipeline (setup first) |
download | Audiobook odmpy only |
ebook / pdf | eBook → PDF/EPUB/ACSM (+ EPUB→PDF) |
doctor | Preflight (setup first) |
gate | Pre-CDP checklist |
plan | Ordered recovery steps |
discover | Build spine.json |
verify | Hard completeness gate |
cdp | Chrome capture (gate first) |
merge / tag | ffmpeg m4b; FULL only if complete |
--code <8digits> — Libby setup code for non-interactive agents--skip-setup — CDP-only debug (fails if odmpy needed and missing)--json — machine-readable outputlibby-dl chrome --loan-url '...' # brings up the CDP debug Chrome this tool needs and opens the loan
Note:
libby-dl's owndiscover/chrome/cdpcommands drive a dedicated CDP debug Chrome internally (their own capture logic, separate fromfcdp/ccb) — this is the libby-cli tool's own mechanism, not the general logged-in-browser default. See thelogged-in-browserskill for driving any OTHER logged-in site.
Re-borrow or use odmpy (libby-dl run after setup). CDP cannot stream expired URLs.
Never tag FULL BOOK until libby-dl verify exits 0.