mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-15 21:46:29 +03:00
Magnus Hedemarkandfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
deb802fbb6
Body was ~19.5k chars, past the new 20k token-budget gate. Collapses Capability Discovery to a stub pointing at the existing references/agent-capability-discovery.md, summarizes Apple Books compatibility instead of duplicating its table, and moves the LLM Configuration Convention plus the Knowledge Extraction Deep Dive into references/llm-config-and-extraction.md. Keeps format essentials, the script decision table, CLI examples, workflows, gotchas, and pitfalls, and extends the references index with the two touched/new files; body is now 16,261 chars. Also adds evals/evals.json (6 output-quality cases incl. one should-not-trigger case) to satisfy the eval-coverage ratchet. The description previously started with "EPUB", which fails the imperative-verb rule that CI enforces on every changed skill; it now leads with "Read" while keeping all trigger keywords. Adds a "When not to use" section (non-EPUB documents, DRM-locked books, Kindle-native formats). Regenerates .claude-plugin/marketplace.json and llms.txt accordingly. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
EPUB — Ebook Creation, Extraction & Enrichment
Expert-level EPUB handling for reading, writing, editing, and extracting knowledge from EPUB2 and EPUB3 files. Ships a CLI tool and five detailed references.
Why Install This Skill
When your agent loads this skill, it becomes an ebook format specialist who can:
- Inspect EPUB structure — see manifest, spine, TOC, metadata
- Extract clean text — per-chapter or single-file, stripped of boilerplate
- Edit EPUBs non-intrusively — metadata, chapters, spine, CSS — without breaking the file
- Create valid EPUBs from scratch — scaffold new ebooks
- Extract knowledge with LLM mode — facts, quotes, definitions, arguments via configurable LLM
- Convert EPUB2 to EPUB3 — add NAV, update namespace, keep NCX compatibility
- Batch process hundreds of EPUBs — wrap any script across file globs
- Validate against the spec — EPUBCheck or Python fallback
What You Get
| Directory | Purpose |
|---|---|
SKILL.md |
Decision table mapping tasks to scripts, EPUB format essentials |
scripts/ |
10 Python CLI scripts: info, text, scaffold, edit, images, batch, convert, validate, extract-knowledge |
references/ |
8 reference files: format internals, Python libraries, spec/validation, tutorials, fixed-layout, accessibility, media overlays |
Triggers
Load this when you encounter EPUB files — to read, create, edit, extract, convert, or validate them.
Requirements
Python 3.8+ with EbookLib. Optional: beautifulsoup4, epublib, Java (for EPUBCheck), and an LLM endpoint for knowledge extraction.
Quick Start
Start with the setup and first workflow in SKILL.md, then use the linked resources for the specific task you need to complete.