← Back to Skills Marketplace
shake

calibre-convert

by shake · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
209
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install calibre-convert
Description
Use this skill when the user wants to convert ebook or document files between formats with Calibre, including EPUB to PDF, Markdown to EPUB, MOBI to EPUB, AZ...
README (SKILL.md)

Calibre Convert

Overview

calibre-convert uses Calibre's ebook-convert CLI to perform ebook and document format conversion. Use it when the user wants a direct file-to-file conversion and the desired input/output formats are supported by Calibre.

Quick Start

  1. Confirm the source file exists and decide the exact output path.
  2. Check whether ebook-convert is available in PATH.
  3. Run the helper script:
./scripts/convert_with_calibre.py /path/to/input.epub /path/to/output.pdf
  1. If the user wants format-specific tuning, pass Calibre arguments after --:
./scripts/convert_with_calibre.py /path/to/book.md /path/to/book.epub -- --chapter "//h:h1" --authors "Example Author"

Workflow

1. Validate inputs

  • Ensure the input file exists.
  • Ensure the output directory exists or create it if the task allows edits there.
  • Infer the requested conversion from the output extension when the user says things like "convert EPUB to PDF".

2. Check Calibre availability

Use the bundled script first. It looks for ebook-convert in PATH, then common macOS install locations.

If Calibre is missing, stop and tell the user exactly which command is missing. Do not pretend the conversion succeeded.

3. Run conversion

The core command is:

ebook-convert input_file output_file [options...]

Common examples:

  • EPUB -> PDF
  • Markdown -> EPUB
  • MOBI -> EPUB
  • AZW3 -> EPUB
  • HTML -> EPUB
  • DOCX -> EPUB

When the user does not specify extra options, prefer the simplest possible conversion.

4. Verify result

  • Confirm the output file was created.
  • Report the final path back to the user.
  • If Calibre emits warnings, summarize only the meaningful parts.

Notes

  • Calibre support varies by format pair and by installed version.
  • PDF output quality depends heavily on source structure and metadata.
  • Markdown input is handled by Calibre's parsers; if the output looks poor, try converting via HTML or adding explicit options.
  • For large batches, loop over files and keep source/target extensions explicit instead of guessing.

Resources

scripts/

  • scripts/convert_with_calibre.py: validates paths, finds ebook-convert, and forwards extra options safely.

references/

  • references/examples.md: ready-to-copy conversion examples and troubleshooting notes.
Usage Guidance
This skill is a simple wrapper for Calibre's ebook-convert. Before installing, ensure you have Calibre (ebook-convert) installed and reachable on PATH (or at one of the macOS paths the script checks). Note the registry metadata doesn't declare the required binary—so the agent will fail if ebook-convert is not present. The script does not auto-create missing output directories (it will return an error), and it runs the external ebook-convert binary without using a shell (no shell injection risk in the wrapper). Because the agent can invoke the skill implicitly, only install it if you are comfortable letting the agent run local conversion commands when asked.
Capability Analysis
Type: OpenClaw Skill Name: calibre-convert Version: 1.0.0 The skill bundle provides a legitimate utility for converting ebook formats using the Calibre 'ebook-convert' CLI. The core logic in 'scripts/convert_with_calibre.py' uses safe subprocess execution practices (passing arguments as a list) and includes basic path validation, with no evidence of malicious intent, data exfiltration, or prompt injection attacks.
Capability Assessment
ℹ Purpose & Capability
The skill's name, description, SKILL.md, and script all align: they wrap Calibre's ebook-convert to convert files. Minor metadata mismatch: the registry lists no required binaries while the runtime clearly depends on the ebook-convert binary being installed and reachable.
✓ Instruction Scope
SKILL.md instructs the agent to validate input/output paths, check for ebook-convert, run the bundled script, and verify output. The included script implements those steps and does not access unrelated files, environment variables, or external endpoints.
✓ Install Mechanism
There is no install spec and no network downloads; the skill is instruction-plus-local-script only. Nothing is written to disk by an installer beyond the shipped files.
✓ Credentials
No credentials, environment variables, or config paths are requested. The script does not attempt to read or exfiltrate secrets.
✓ Persistence & Privilege
The skill is not always-enabled and uses normal implicit invocation. It does not modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install calibre-convert
  3. After installation, invoke the skill by name or use /calibre-convert
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of calibre-convert skill for converting ebook and document files between formats using Calibre’s `ebook-convert` CLI. - Supports common conversions such as EPUB to PDF, Markdown to EPUB, MOBI to EPUB, AZW3 to EPUB, HTML to EPUB, and DOCX to EPUB. - Provides a helper script (`convert_with_calibre.py`) for path validation and safe CLI argument forwarding. - Includes clear workflow for input validation, Calibre availability check, file conversion, and result verification. - Offers documentation with usage examples, troubleshooting notes, and a resources section for further guidance.
Metadata
Slug calibre-convert
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is calibre-convert?

Use this skill when the user wants to convert ebook or document files between formats with Calibre, including EPUB to PDF, Markdown to EPUB, MOBI to EPUB, AZ... It is an AI Agent Skill for Claude Code / OpenClaw, with 209 downloads so far.

How do I install calibre-convert?

Run "/install calibre-convert" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is calibre-convert free?

Yes, calibre-convert is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does calibre-convert support?

calibre-convert is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created calibre-convert?

It is built and maintained by shake (@shake); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments