@mahmudulrubel/custom-epub-creator-skill
v1.0.1
Published
Installer for custom-epub-creator AI Agent Skill
Downloads
201
Maintainers
Readme
Custom ePub & Kindle E-Book Publisher
An open-source AI Agent Skill for generating production-ready ePub 3 e-books and 6x9 Trade Paperback Kindle PDFs complete with automated cover graphic design, structured chapter navigation, dynamic running headers, embedded CSS typography, and page numbering.
📋 Table of Contents
- Overview
- Key Features
- Installation Guide
- Usage Examples & Prompts
- Technical Architecture
- Dependencies
- License & Contributing
📖 Overview
Custom ePub & Kindle E-Book Publisher equips AI coding assistants (such as Google Gemini, Claude, Antigravity, Cursor, and VS Code AI tools) with standard publishing workflows to author, compile, and format valid digital e-books.
Whether you're creating trivia books, technical handbooks, user documentation, novels, or study guides, this skill instructs your AI assistant on building validated ePub 3 packages (.epub) and print-ready PDF files (.pdf).
✨ Key Features
- 📱 ePub 3 Package Compiler: Valid ePub 3 with metadata (
DC:title,DC:creator,DC:language),toc.ncxnavigation,nav.xhtml, and embedded CSS optimized for Kindle, Apple Books, and Kobo. - 📄 6x9 Trade Paperback PDF: Compiles standard 6x9 inch publication layouts with dynamic two-pass canvas page numbering (
Page X of Y), running header rules, and proper margin flows using ReportLab. - 🎨 Automated High-Res Cover Graphic: Dynamically renders
1200x1800PNG cover graphics using Python Pillow (PIL) tailored to the book's theme. - ⚡ One-Command Installation: Installs seamlessly into global or local project AI skill folders via
npx.
🚀 Installation Guide
Option 1: NPX One-Line Installer (Recommended)
Global Installation (For All Projects)
Installs the skill globally into ~/.gemini/config/skills/custom-epub-creator:
npx @mahmudulrubel/custom-epub-creator-skillLocal Workspace Installation
Installs the skill directly into your current project workspace .agents/skills/custom-epub-creator:
npx @mahmudulrubel/custom-epub-creator-skill --localOption 2: Skillfish CLI
If you use skillfish for managing AI agent skills:
npx skillfish add MahmudulRubel/Custom-ePub-CreatorOption 3: Direct Git Clone
Global Installation
git clone https://github.com/MahmudulRubel/Custom-ePub-Creator.git ~/.gemini/config/skills/custom-epub-creatorLocal Installation
git clone https://github.com/MahmudulRubel/Custom-ePub-Creator.git .agents/skills/custom-epub-creator💡 Usage Examples & Prompts
Once installed, your AI assistant will automatically recognize e-book generation requests. You can prompt your AI with:
Example Prompts:
"Create a 5-chapter trivia e-book about world history in both ePub and PDF formats."
"Generate a formatted Kindle PDF and ePub for my Python beginner guide with custom cover art."
"Compile this markdown documentation into a valid 6x9 inch trade paperback PDF with page numbers."
🛠 Technical Architecture
Custom-ePub-Creator/
├── SKILL.md # Primary YAML frontmatter & AI Agent instructions
├── README.md # Documentation & installation guide
├── package.json # NPM package manifest for npx installer
├── bin/
│ └── install.js # CLI installation runner
└── .gitignore # Excludes temporary outputs (*.pdf, *.epub, cover.png)📦 Dependencies
The skill utilizes the following standard Python libraries:
| Library | Purpose |
| :--- | :--- |
| ebooklib | Assembles valid ePub 3 manifest files, spine, TOC, and metadata. |
| reportlab | Generates 6x9 inch trade paperback PDFs with dynamic headers and footers. |
| Pillow (PIL) | Programmatically designs and renders high-resolution cover graphics (cover.png). |
| pypdf | Inspects page metrics and verifies structural integrity. |
Install Python dependencies if needed:
pip install ebooklib reportlab pillow pypdf📄 License & Contributing
Distributed under the MIT License. See LICENSE for more information.
Contributions, issues, and feature requests are welcome! Feel free to check the Issues Page.
