Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Improved error handling and comments in Python analysis scripts. - Updated prompt instructions for subagent analysis to clarify required structure and language use. - Minor documentation adjustments for clarity in orchestration and session policies.
What This Skill Does
Reads book catalog data from a Calibre Content server using calibredb, supporting list, search, and ID lookups. Runs a one-book AI analysis pipeline that extracts text, generates a structured analysis via a subagent, and writes the result as an HTML block back to the book's comments field. Analysis state is cached in SQLite to avoid reprocessing unchanged books.
The two-turn async design and SQLite cache let long analysis jobs run without blocking the chat session or reprocessing books that have not changed.
When to use it
- Searching a remote Calibre library for books in a specific series
- Looking up full metadata for a single book by its Calibre ID
- Running AI analysis on a novel and saving the result to its Calibre comments
- Checking whether a book has already been analyzed before triggering a new pipeline run
- Listing all books from a Calibre Content server in structured JSON
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: analyze book ID 3 from my Calibre library in Japanese
- 1Validate book ID and confirm subagent settings (model, thinking level, timeout) for the session
- 2Run prepare_subagent_input.mjs to extract text and split it into chunked source files
- 3Use subagent-spawn-command-builder to generate the sessions_spawn payload, then call sessions_spawn
- 4Register the run in runs.json with runId, book_id, title, and status running, then reply to user that analysis is running in background
- 5On completion event, call handle_completion.mjs to load the analysis JSON, apply HTML to Calibre comments via calibredb, and remove the run record
Structured AI analysis written to the book's Calibre comments field as HTML, with cache record stored in calibre_analysis.sqlite
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.