epub2skill

Convert EPUB books into agent skill directories with SKILL.md and bookindex.md.

5|1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/yearzen1/epub2skill --skill epub2skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: epub2skill
Source: https://github.com/yearzen1/epub2skill/tree/main
Command: npx skills add https://github.com/yearzen1/epub2skill --skill epub2skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, epub2md, fast-glob, fs-extra.

What problem does it solve?

Converting personal EPUB reading collections into agent-ready, citation-friendly skill folders is tedious and manual, especially when you need consistent output across multiple models and directory targets.

Core Features & Use Cases

  • Scaffold skill directories automatically: generates a skill folder containing SKILL.md, bookindex.md, and per-book markdown content under resources/.
  • Batch EPUB conversion with glob support: converts one or many EPUB files in a single run, with optional merged markdown per book.
  • Deploy to popular skill targets: writes output into Claude/OpenCode/Qwen project-level or global skill locations.

Use case: Transform a philosophy reading list into an agent knowledge base so the agent can answer questions while grounding responses in exact chapter/file paths produced during conversion.

Quick Start

Run epub2skill to convert your EPUB glob into an output skill folder named stoicism-guide and include a custom description in SKILL.md.

Frequently Asked Questions about epub2skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert EPUB files into a markdown knowledge base for AI agents?

Converting EPUB files to markdown for an agent knowledge base involves parsing the book contents and generating structured skill directories. This scaffolding process creates a folder with SKILL.md, bookindex.md, and per-book markdown resources for knowledge-grounded answering.

Can I batch process multiple EPUB books into a single agent skill folder?

Yes, you can batch process multiple EPUB books into a single skill folder using glob support. The tool resolves globbed .epub inputs in a single run and optionally merges the EPUB-to-markdown output into one structured directory for your agent.

Does this EPUB to markdown conversion tool support Claude and Qwen project layouts?

Yes, the EPUB to markdown conversion tool supports Claude, OpenCode, and Qwen project-level or global skill layouts. It writes structured output directly to your chosen target directories to fit your specific agent environment.

What is the best way to structure EPUB content for citation-friendly agent responses?

The best way to structure EPUB content for citation-friendly agent responses is to generate a skill directory with exact chapter and file paths. This scaffolding approach produces bookindex.md and per-book markdown content, allowing agents to ground answers in specific text locations.

Do I need to validate skill names when scaffolding an EPUB knowledge base?

Yes, you need to validate skill names when scaffolding an EPUB knowledge base because the CLI orchestration requires deterministic naming. The conversion process validates kebab-case skill names to ensure proper directory generation and agent compatibility.