skills.rest
HKUDS
HKUDSOFFICIAL
Explore all skills by this author →
WebsiteGitHub

cli-anything-calibre

Manages Calibre e-book libraries, metadata, and format conversion via a stateful CLI.

48.8k|4.5k|Updated Mar 8, 2026
Search Tags:#CLI#Metadata#ebook#calibre#format conversion#ePub#library management
One-click install
npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-calibre
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cli-anything-calibre
Source: https://github.com/HKUDS/CLI-Anything/tree/main/calibre/agent-harness/cli_anything/calibre/skills
Command: npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-calibre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing e-book libraries through Calibre's native tools requires memorizing complex command syntax across calibredb, ebook-convert, and ebook-meta, making it hard for AI agents and scripts to automate library operations reliably.

Core Features & Use Cases

  • Library & Book Management: Connect to a Calibre library, list, search, add, remove, and export books using the Calibre query language.
  • Metadata Editing: Get and set metadata fields (title, authors, tags, series, rating) and embed metadata directly into book files.
  • Format Conversion & Chapter Export: Convert between EPUB, MOBI, AZW3, PDF and more, or export each chapter of an EPUB as a separate PDF.
  • Use Case: An AI agent can search a library for "author:asimov and tags:scifi", convert the matching EPUBs to MOBI, and update their series metadata — all through structured JSON output.

Quick Start

Ask the agent to connect to your Calibre library and list all books by a specific author in JSON format.

Frequently Asked Questions about cli-anything-calibre

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

FAQPage Schema
How do I convert EPUB to MOBI from the command line?▼

Use the formats convert command with the book ID and formats, such as converting book 42 from EPUB to MOBI. The CLI wraps Calibre's ebook-convert tool and supports EPUB, MOBI, AZW3, PDF, DOCX, and other formats.

How do I search Calibre library books by author or tags?▼

Use the books search command with Calibre query language, for example "author:asimov and tags:scifi" or "rating:>3". The query language supports field matching, date ranges, negation, and boolean combinations.

Does this CLI require Calibre to be installed?▼

Yes, Calibre is a hard dependency because the CLI wraps the real calibredb, ebook-convert, and ebook-meta binaries. Install Calibre via apt on Debian/Ubuntu or Homebrew on macOS and verify the tools are in your PATH.

Can AI agents parse the CLI output programmatically?▼

Yes, every command supports a --json flag that emits structured JSON instead of human-readable tables. Agents should also check return codes and parse stderr for error messages on failure.

Why does chapter export fail for my book?▼

Chapter export requires the book to be in EPUB format. If the book is in another format, convert it to EPUB first using the formats convert command, then run books export-chapters.

Related Skills

Explore More Software Engineering Skills→
hhellbuschhhellbusch
7

reference

Organize, search, and enrich personal reference library entries.

Community
Intermediate
mscully4mscully4

calibre

Manage e-book libraries and send books to Kindle via email.

Community
Intermediate
claudioborjaclaudioborja

skill-barcode-isbn

Normalize and validate ISBN inputs, converting them to ISBN-13.

Community
Advanced
unixfgunixfg

ebook-library

Query and manage a local Calibre ebook library via metadata.db and full-text-search.db.

Community
Intermediate