A professional CLI-based skill for inspecting EPUB metadata and converting e-books into clean, structured Markdown files.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install epub2md-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install epub2md-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is epub2md-cli?
The epub2md-cli skill is a robust integration designed for Openclaw Skills that leverages the power of the epub2md engine. It allows AI agents to interact with local EPUB files, providing capabilities to extract metadata, visualize table of contents, and perform high-fidelity conversions to Markdown. Whether you need a single consolidated document or a structured directory of individual chapters, this skill handles the heavy lifting of e-book parsing.
Built with developer workflows in mind, it includes a specialized Python wrapper script to manage workspace layouts and resolve common pathing quirks. This ensures that your conversion results remain organized in a dedicated workspace, keeping your source files safe while automating the generation of localized assets like images and formatted text.
epub2md-cli Use Cases
- Converting local EPUB books into Markdown for easier reading or documentation.
- Extracting specific chapter structures and nesting information from e-books.
- Merging multiple EPUB chapters into a single, cohesive Markdown file with custom naming.
- Localizing remote images within an EPUB to create a fully offline-accessible Markdown version.
- Inspecting book metadata and section lists without performing a full conversion.
How epub2md-cli Works
- The AI agent identifies a local EPUB file and determines the user's intent (inspection vs. conversion).
- If conversion is requested, the agent verifies the workspace layout within the Openclaw Skills environment.
- A bundled Python wrapper script is invoked to manage the conversion process, ensuring stable output paths.
- The epub2md engine parses the EPUB, handling complex tasks like HTML-to-Markdown mapping and image extraction.
- Results are categorized into inputs, outputs, and inspection logs, which are then reported back to the user with concrete file paths.
epub2md-cli Setup
First, ensure the core utility is available in your environment:
# Check if epub2md is installed
command -v epub2md
# If missing, install via npm
npm install -g epub2md
Note: For image localization features, Node.js version 18.0.0 or higher is required.
epub2md-cli Data Schema & Taxonomy
The skill follows a strict hierarchical workspace structure located at /home/admin1/.agents/skills/epub2md-cli-workspace/{bookname}/:
| Directory | Description |
|---|---|
inputs/ |
Contains a copy of the original source EPUB file. |
outputs/split/ |
Contains individual Markdown files for each chapter (e.g., 001-intro.md). |
outputs/merge/ |
Contains the single merged Markdown file and a local images/ folder. |
outputs/inspect/ |
Stores JSON or text results from metadata and structure scans. |
epub2md-cli Advanced Features
- Smart path handling for EPUB filenames containing special glob characters like
[or*. - Wrapper-enforced workspace isolation to prevent messy file generation in user directories.
- Support for
--autocorrectto automatically fix spacing and punctuation in generated Markdown. - Advanced inspection modes using
--sectionsto extract raw HTML payloads for deep content analysis. - Batch processing support for converting entire directories of e-books using quoted glob patterns.
SKILL.md
Loading
Related Openclaw Skills
No More Forget
A comprehensive memory optimization toolkit that prevents agent amnesia, slashes token consumption, and enhances semantic search capabilities.
UniFi Integration
A read-only monitoring skill for UniFi networks that provides instant visibility into devices, clients, health, and traffic data.
Image Collect
A specialized tool for extracting structured knowledge, OCR text, and summaries from images to be stored in a local database.
KingSumo
A comprehensive integration for KingSumo that enables AI agents to automate viral giveaway management and email list growth.
OpenClaw Dashboard Theme Changer
A dynamic theme customization tool that updates OpenClaw Dashboard accent colors and UI variables through a single command or natural language request.
minimax-mcp
A high-performance MCP skill for OpenClaw that provides native MiniMax web search and image understanding with automated fallback protection.
Featured*
