npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@mahmudulrubel/custom-epub-creator-skill

v1.0.1

Published

Installer for custom-epub-creator AI Agent Skill

Downloads

201

Readme

Custom ePub & Kindle E-Book Publisher

npm version license npm downloads GitHub stars

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

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.ncx navigation, 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 1200x1800 PNG 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-skill

Local Workspace Installation

Installs the skill directly into your current project workspace .agents/skills/custom-epub-creator:

npx @mahmudulrubel/custom-epub-creator-skill --local

Option 2: Skillfish CLI

If you use skillfish for managing AI agent skills:

npx skillfish add MahmudulRubel/Custom-ePub-Creator

Option 3: Direct Git Clone

Global Installation

git clone https://github.com/MahmudulRubel/Custom-ePub-Creator.git ~/.gemini/config/skills/custom-epub-creator

Local 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.