calibre-metadata-apply
by nextaltair
DevOps & CloudBrief
Apply metadata updates to existing Calibre books via calibredb over a Content server.
Description
What This Skill Does
Updates metadata on existing books in a Calibre library using calibredb over a Content server. Requires confirmed book IDs before writing and enforces a mandatory dry-run before any changes are applied. Supports fields like title, authors, series, tags, publisher, pubdate, and structured HTML comment blocks.
Requires ID confirmation and a dry-run gate before any remote write, reducing the risk of bulk metadata corruption common with direct calibredb usage.
When to Use It
- Correcting author names on imported ebooks
- Adding series and series index to a book collection
- Fixing publication dates on scanned PDFs
- Bulk updating tags after a library reorganization
- Setting language fields on foreign-language titles
Example Workflow
User asks: update the author and series fields for books with IDs 42 and 43
- 1
Runs a read-only lookup and displays current title, authors, series, and series_index for IDs 42 and 43
- 2
Asks user to confirm the target IDs before proceeding
- 3
Builds a JSONL payload with the approved field changes
- 4
Runs a dry-run to preview the changes without applying them
- 5
Applies changes after explicit user approval and re-reads final values to confirm
Author and series metadata updated on the Calibre Content server for the confirmed book IDs
Requirements
- CALIBRE_PASSWORD environment variable
- Calibre installed with calibredb available on PATH
- Calibre Content server running and accessible at a known URL
Installation
clawhub install nextaltair/calibre-metadata-applyRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.