Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

MITAuto-check passedDevOps & Cloud

Install Calibredb

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill calibredb -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins calibredb --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/LVTD-LLC/skills/skills/calibredb .claude/skills/calibredb && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
calibredb
GitHub stars
1.3k
Token cost
~1k tokens
SKILL.md length
293 words
Files
5 (incl. scripts, references, assets)
Skills in repo
714
Repo updated
First seen
Licence
MIT

At a glance

Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

  • Works in 6 steps: List books → Search and get IDs → Show metadata → …
  • Searching/filtering library records
  • SKILL.md covers Library path, Safety model, Core workflow and Quick command patterns, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Calibredb is an agent skill from hashgraph-online/awesome-codex-plugins. Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs). Use when listing books, searching/filtering library records, reading/updating metadata, adding/removing formats, exporting books, maintaining custom columns, running library checks, managing FTS indexing/search, or creating catalogs/backups from a Calibre library.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts, reference files and assets (for example `references/command-matrix.md`, `references/safe-workflows.md` and `scripts/list_books_json.py`). Compatibility notes: Codex, Claude Code, and other Agent Skills-compatible clients.

It sits in DevOps & Cloud, covering Backup and disaster recovery. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is MIT.

When your agent uses it

  • Searching/filtering library records
  • Reading/updating metadata
  • Adding/removing formats
  • Exporting books

Example prompts

  • “/calibredb”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients.

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. List books
  2. Search and get IDs
  3. Show metadata
  4. Update metadata fields
  5. Add/export books
  6. Library health check

What it can do on your machine

Read from SKILL.md and the folder at commit 9e7b281. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Codex, Claude Code, and other Agent Skills-compatible clients.

    From compatibility in the SKILL.md frontmatter.

Context cost

Calibredb loads about 1k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 95 tokens; SKILL.md has 293 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from hashgraph-online/awesome-codex-plugins at commit 9e7b281, republished under its MIT licence (© hashgraph-online). 293 words, ~1,010 tokens.

Download SKILL.mdSave it as .claude/skills/calibredb/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
calibredb
description
Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs). Use when listing books, searching/filtering library records, reading/updating metadata, adding/removing formats, exporting books, maintaining custom columns, running library checks, managing FTS indexing/search, or creating catalogs/backups from a Calibre library.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.
license
MIT
metadata.version
0.1.0
metadata.displayName
CalibreDB
metadata.category
Knowledge Management
metadata.tags
calibre,ebooks,library-management,metadata,cli

CalibreDB

Use this skill for all command-line operations on Calibre libraries.

Library path

  • Calibre library locations are user-specific. Identify the target library path or Content server URL before running commands.
  • Prefer explicit path in every command: --with-library "$CALIBRE_LIBRARY".
  • If the user has not provided a library path, ask for it or inspect the local environment for an existing Calibre library before proceeding.
  • For machine-readable outputs, use --for-machine or JSON-capable subcommands.

Safety model

Start with read-only operations, then escalate only when needed.

Read-only (safe by default)
  • list
  • search
  • show_metadata
  • custom_columns
  • list_categories
  • check_library
  • fts_search
  • fts_index status
Mutating (confirm intent for destructive/irreversible)
  • Usually safe with clear intent: add, set_metadata, set_custom, add_format, embed_metadata, backup_metadata
  • Confirm before destructive actions: remove, remove_format, remove_custom_column, restore_database, fts_index reindex on full library

Core workflow

  1. Identify target library and set --with-library.
  2. Discover relevant book IDs with search (or list --search).
  3. Inspect records with show_metadata or list --for-machine.
  4. Apply minimal required mutations.
  5. Validate with follow-up list/search/show_metadata.

Quick command patterns

1) List books
bash
export CALIBRE_LIBRARY="/path/to/Calibre Library"
calibredb list --with-library "$CALIBRE_LIBRARY" --fields id,title,authors,formats --limit 20

Machine output:

bash
calibredb list --with-library "$CALIBRE_LIBRARY" --fields id,title,authors,tags,formats --for-machine
2) Search and get IDs
bash
calibredb search --with-library "$CALIBRE_LIBRARY" "title:python"

Use IDs in follow-up commands.

3) Show metadata
bash
calibredb show_metadata --with-library "$CALIBRE_LIBRARY" 123

As OPF:

bash
calibredb show_metadata --with-library "$CALIBRE_LIBRARY" --as-opf 123
4) Update metadata fields
bash
calibredb set_metadata --with-library "$CALIBRE_LIBRARY" 123 \
  --field title:"Example Book" \
  --field tags:"python,reference"
5) Add/export books
bash
calibredb add --with-library "$CALIBRE_LIBRARY" "/path/to/book.epub"
calibredb export --with-library "$CALIBRE_LIBRARY" 123 --to-dir "/tmp/export"
6) Library health check
bash
calibredb check_library --with-library "$CALIBRE_LIBRARY"

Content server usage

To target a running Calibre Content server:

bash
calibredb list --with-library "http://hostname:8080/#library_id" --username <user> --password <pass>

From docs: use special #- library id to list server libraries.

Security note: a literal --password <pass> value is passed as a process argument and may be visible to other users on shared machines via process-listing tools. Prefer --password '<stdin>' with the password piped from a password manager, or --password '<f:/path/to/file>' with a 0600 credential file stored outside the repository. Prefer local or trusted hosts for authenticated Content server commands, and redact credentials from shell history, logs, and task transcripts.

Reference files

  • Command matrix + options: references/command-matrix.md
  • Safe operational playbooks: references/safe-workflows.md

© hashgraph-online, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references, assets) in plugins/LVTD-LLC/skills/skills/calibredb of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • assets/app-icon.png
  • references/command-matrix.md
  • references/safe-workflows.md
  • scripts/list_books_json.py

Open the folder on GitHubat commit 9e7b281

Compare with similar skills

Calibredb next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Calibredb compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Calibredb this skillhashgraph-online/awesome-codex-plugins1.3k—~1kAutomated safety check: PassMIT
OmniRoute Backup and Sync CLIdiegosouzapw/OmniRoute74k—~948Automated safety check: PassMIT
Pymobiledevice3 Device Operatordoronz88/pymobiledevice32.9k—~1.8kAutomated safety check: NotesGPL-3.0
Myclaw BackupLeoYeAI/openclaw-backup659—~1.8kAutomated safety check: PassMIT
OmniRoute Database Backupsdiegosouzapw/OmniRoute74k—~395Automated safety check: PassMIT
Tempsgotempsh/temps828—~2kAutomated safety check: PassApache-2.0

Similar skills

  • OmniRoute Backup and Sync CLI

    diegosouzapw/OmniRoute

    Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.

    74k GitHub stars~948 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Pymobiledevice3 Device Operator

    doronz88/pymobiledevice3

    Operate iOS and iPadOS devices with pymobiledevice3, from a local checkout or straight from PyPI via uvx on a fresh workstation.

    2.9k GitHub stars~1.8k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Myclaw Backup

    LeoYeAI/openclaw-backup

    Backup and restore all OpenClaw configuration, agent memory, skills, and workspace data.

    659 GitHub stars~1.8k tokensUpdated 7 mo ago
    DevOps & CloudAuto-check passed
  • OmniRoute Database Backups

    diegosouzapw/OmniRoute

    Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

    74k GitHub stars~395 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Temps

    gotempsh/temps

    Manage, deploy, operate, and instrument applications with Temps.

    828 GitHub stars~2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Hermes Offsite Backup

    OnlyTerp/hermes-optimization-guide

    Set up encrypted off-machine Hermes backups. An agent skill from OnlyTerp/hermes-optimization-guide.

    687 GitHub stars~772 tokensUpdated 15 days ago
    DevOps & CloudAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 714 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.3k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.3k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.3k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.3k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.3k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.3k GitHub stars~875 tokensUpdated today
    Auto-check passed

Categories

Questions about Calibredb

What does Calibredb do?

Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs). Calibredb is an agent skill from hashgraph-online/awesome-codex-plugins. Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

When should I use Calibredb?

Calibredb fits situations like: searching/filtering library records; reading/updating metadata; adding/removing formats; exporting books.

How do I install Calibredb in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill calibredb -a claude-code`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/calibredb in hashgraph-online/awesome-codex-plugins) into .claude/skills/calibredb in your project. Claude Code loads it when a task matches its description.

How do I install Calibredb in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill calibredb -a codex`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/calibredb in hashgraph-online/awesome-codex-plugins) into .agents/skills/calibredb in your project. Codex loads it when a task matches its description.

Can I use Calibredb in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hashgraph-online/awesome-codex-plugins --skill calibredb -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/calibredb, .gemini/skills/calibredb, .github/skills/calibredb and .opencode/skills/calibredb in your project.

What does Calibredb need to run?

Going by SKILL.md and its folder, Calibredb needs Python for the scripts in its folder. Our summary lists: Python 3. Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients..

Does Calibredb access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Calibredb safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Calibredb use?

Calibredb is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Calibredb use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 954 tokens, read only when the agent opens those files.

What are the alternatives to Calibredb?

Skills that share tags, products or a category with Calibredb: OmniRoute Backup and Sync CLI (diegosouzapw/OmniRoute, 74k stars), Pymobiledevice3 Device Operator (doronz88/pymobiledevice3, 2.9k stars), Myclaw Backup (LeoYeAI/openclaw-backup, 659 stars) and OmniRoute Database Backups (diegosouzapw/OmniRoute, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Calibredb?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,255 GitHub stars. The repository holds 714 skills in this directory. The repository was last updated on October 9, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.