Markdown Article Formatter
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
Command-line interface for Calibre - A stateful CLI harness for e-book library management, metadata editing, and format conversion wrapping the real Calibre tools (calibredb, ebook-convert…
Install CLI Anything Calibre
$ npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install HKUDS/CLI-Anything cli-anything-calibre --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/HKUDS/CLI-Anything.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cli-anything-calibre .claude/skills/cli-anything-calibre && rm -rf skills-srcUse ~/.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/
Install the "cli-anything-calibre" agent skill from https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-calibre into .claude/skills/cli-anything-calibre/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-anything-calibre", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-calibreType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install HKUDS/CLI-Anything cli-anything-calibre --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/CLI-Anything.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/cli-anything-calibre .agents/skills/cli-anything-calibre && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cli-anything-calibre" agent skill from https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-calibre into .agents/skills/cli-anything-calibre/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-anything-calibre", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install HKUDS/CLI-Anything cli-anything-calibre --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/CLI-Anything.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/cli-anything-calibre .cursor/skills/cli-anything-calibre && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cli-anything-calibre" agent skill from https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-calibre into .cursor/skills/cli-anything-calibre/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-anything-calibre", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/HKUDS/CLI-Anything.git --path skills/cli-anything-calibre--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install HKUDS/CLI-Anything cli-anything-calibre --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/CLI-Anything.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/cli-anything-calibre .gemini/skills/cli-anything-calibre && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cli-anything-calibre" agent skill from https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-calibre into .gemini/skills/cli-anything-calibre/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-anything-calibre", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install HKUDS/CLI-Anything cli-anything-calibreInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/HKUDS/CLI-Anything.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/cli-anything-calibre .github/skills/cli-anything-calibre && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cli-anything-calibre" agent skill from https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-calibre into .github/skills/cli-anything-calibre/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-anything-calibre", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install HKUDS/CLI-Anything cli-anything-calibre --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/CLI-Anything.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/cli-anything-calibre .opencode/skills/cli-anything-calibre && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cli-anything-calibre" agent skill from https://github.com/HKUDS/CLI-Anything/tree/main/skills/cli-anything-calibre into .opencode/skills/cli-anything-calibre/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cli-anything-calibre", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
cli-anything-calibre- GitHub stars
- 52k
- Token cost
- ~1.8k tokens
- SKILL.md length
- 576 words
- Files
- 1
- Skills in repo
- 78
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Command-line interface for Calibre - A stateful CLI harness for e-book library management, metadata editing, and format conversion wrapping the real Calibre tools (calibredb, ebook-convert…
- Works in 6 steps: Always use --json flag for parseable… → Check return codes - 0 for success,… → Parse stderr for error messages on failure → …
- Documents & Office work in your project
- SKILL.md covers Installation, Usage, Command Groups and Examples, plus 8 more sections
- Calls pip, apt-get and brew
What it does
CLI Anything Calibre is an agent skill from HKUDS/CLI-Anything. Command-line interface for Calibre - A stateful CLI harness for e-book library management, metadata editing, and format conversion wrapping the real Calibre tools (calibredb, ebook-convert, ebook-meta)...
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office. The repository describes itself as: "CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/. The licence is Apache-2.0.
When your agent uses it
- Documents & Office work in your project
Example prompts
- “/cli-anything-calibre”
Requirements
- Python 3
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Always use --json flag for parseable output
- Check return codes - 0 for success, non-zero for errors
- Parse stderr for error messages on failure
- Verify outputs exist after export/conversion operations
- Use --library flag or CALIBRE_LIBRARY env to specify library path
- Chapter export requires EPUB format - convert first if needed
What it can do on your machine
Read from SKILL.md and the folder at commit 34f5195. 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
Shell commands in SKILL.md call:
pipapt-getbrew
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.
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.
Context cost
CLI Anything Calibre loads about 1.8k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 576 words of instructions outside code blocks.
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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteRuns commands with sudoSKILL.md:25
sudo apt-get install calibre
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); files beside SKILL.md are not scanned.
SKILL.md
The full file from HKUDS/CLI-Anything at commit 34f5195, republished under its Apache-2.0 licence (© HKUDS). 576 words, ~1,846 tokens.
Download SKILL.mdSave it as
.claude/skills/cli-anything-calibre/SKILL.md (or your agent's skills folder).- name
- cli-anything-calibre
- description
- Command-line interface for Calibre - A stateful CLI harness for e-book library management, metadata editing, and format conversion wrapping the real Calibre tools (calibredb, ebook-convert, ebook-meta)...
cli-anything-calibre
A stateful CLI harness for Calibre e-book management. Wraps the real Calibre tools (calibredb, ebook-convert, ebook-meta) to give AI agents and scripts a clean, structured interface for library operations, metadata editing, and format conversion.
Installation
This CLI is installed as part of the cli-anything-calibre package:
pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=calibre/agent-harnessPrerequisites:
- Python 3.10+
- Calibre must be installed on your system (hard dependency)
# Debian/Ubuntu
sudo apt-get install calibre
# macOS
brew install --cask calibre
# Verify tools are in PATH
which calibredb
which ebook-convert
which ebook-metaUsage
Basic Commands
# Show help
cli-anything-calibre --help
# Start interactive REPL mode
cli-anything-calibre
# Connect to a Calibre library
cli-anything-calibre library connect ~/Calibre\ Library
# Run with JSON output (for agent consumption)
cli-anything-calibre --json books listREPL Mode
When invoked without a subcommand, the CLI enters an interactive REPL session:
cli-anything-calibre
# Enter commands interactively with tab-completion and history
# Use 'help' to see available commands
# Use 'quit' or 'exit' to leaveCommand Groups
Library
Library management commands.
| Command | Description |
|---|---|
connect <path> | Set active library path |
info | Show library statistics (book count, formats, db size) |
check | Verify library integrity using calibredb check_library |
Books
Book operations (wrap calibredb).
| Command | Description |
|---|---|
list | List books with filtering and sorting |
search <query> | Search using Calibre query language |
add <files> | Add book files to library |
remove <ids> | Remove books (move to trash or permanent delete) |
show <id> | Show full metadata for a book |
export <ids> | Export books to directory |
export-chapters <id> | Export each chapter as separate PDF (requires EPUB format) |
Meta
Metadata editing (wrap calibredb set_metadata).
| Command | Description |
|---|---|
get <id> [field] | Get metadata (all or specific field) |
set <id> <field> <value> | Set a metadata field |
embed <ids> | Embed metadata into book files |
Formats
Format management (wrap calibredb + ebook-convert).
| Command | Description |
|---|---|
list <id> | List available formats for a book |
add <id> <file> | Add a format to a book |
remove <id> <fmt> | Remove a format from a book |
convert <id> <input_fmt> <output_fmt> | Convert book format |
Custom
Custom columns (wrap calibredb).
| Command | Description |
|---|---|
list | List all custom columns |
add <label> <name> <type> | Create custom column |
remove <label> | Delete custom column |
set <id> <label> <value> | Set custom field value |
Catalog
Catalog generation.
| Command | Description |
|---|---|
catalog <output> | Generate a catalog of the library (EPUB, CSV, or OPDS) |
Examples
Connect and List Books
Connect to your Calibre library and list books.
cli-anything-calibre library connect ~/Calibre\ Library
cli-anything-calibre books list
# Or with JSON output
cli-anything-calibre --json books list --search "author:asimov"Search and Filter
Search books using Calibre query language.
cli-anything-calibre books search "title:Foundation"
cli-anything-calibre books search "author:asimov and tags:scifi"
cli-anything-calibre books search "rating:>3"Metadata Editing
Set metadata fields on books.
cli-anything-calibre meta set 42 title "New Title"
cli-anything-calibre meta set 42 series "Foundation"
cli-anything-calibre meta set 42 series_index 1
cli-anything-calibre meta set 42 tags "scifi,classic"
cli-anything-calibre meta set 42 rating 5Format Conversion
Convert between e-book formats.
cli-anything-calibre formats convert 42 EPUB MOBI
cli-anything-calibre formats convert 42 EPUB PDF --output /tmp/book.pdfExport Chapters as PDFs
Export each chapter of an EPUB as a separate PDF file.
cli-anything-calibre books export-chapters 42 --to-dir ./pdfs
cli-anything-calibre books export-chapters 42 --to-dir ./pdfs --chapters 1-5Calibre Query Language
Used with books search and books list --search:
author:asimov # Author contains "asimov"
title:"Foundation" # Title phrase
tags:fiction # Tag match
rating:>3 # Rating greater than 3
series:"Foundation" # Series match
pubdate:[2020-01-01,2021-12-31] # Date range
identifiers:isbn:1234567890 # Specific identifier
has:cover # Has cover image
not:tags:fiction # Negation
author:asimov and tags:scifi # Boolean ANDShow full SKILL.md (225 more words)Show less
Key Metadata Fields
| Field | Type | Description |
|---|---|---|
title | text | Book title |
authors | text | Author names (&-separated) |
tags | text | Comma-separated tags |
series | text | Series name |
series_index | float | Position in series |
rating | float | Rating 1-5 |
publisher | text | Publisher name |
pubdate | datetime | Publication date |
comments | text | Description/comments |
languages | text | Language codes |
identifiers | text | ISBN, ASIN, etc. (type:value) |
Supported Formats
Input: EPUB, MOBI, AZW, AZW3, PDF, HTML, DOCX, ODT, FB2, TXT, RTF, LIT, and more
Output (conversion): EPUB, MOBI, AZW3, PDF, HTML, DOCX, TXT, and more
State Management
The CLI maintains session state with:
- Session file:
~/.cli-anything-calibre/session.json - Library path persistence: Active library is saved across sessions
- Environment override:
CALIBRE_LIBRARYenvironment variable
Output Formats
All commands support dual output modes:
- Human-readable (default): Tables, colors, formatted text
- Machine-readable (
--jsonflag): Structured JSON for agent consumption
# Human output
cli-anything-calibre books list
# JSON output for agents
cli-anything-calibre --json books listFor AI Agents
When using this CLI programmatically:
- Always use
--jsonflag for parseable output - Check return codes - 0 for success, non-zero for errors
- Parse stderr for error messages on failure
- Verify outputs exist after export/conversion operations
- Use
--libraryflag orCALIBRE_LIBRARYenv to specify library path - Chapter export requires EPUB format - convert first if needed
More Information
- Full documentation: See README.md in the package
- Architecture SOP: See CALIBRE.md in the agent-harness directory
- Test coverage: See test_core.py and test_full_e2e.py in the tests directory
- Methodology: See HARNESS.md in the cli-anything-plugin
Version
1.0.0
© HKUDS, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/cli-anything-calibre of HKUDS/CLI-Anything.
Open the folder on GitHubat commit 34f5195
Compare with similar skills
CLI Anything Calibre 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| CLI Anything Calibre this skillHKUDS/CLI-Anything | 52k | — | ~1.8k | Automated safety check: Notes | Apache-2.0 | |
| Markdown Article FormatterJimLiu/baoyu-skills | 27k | 6 repos | ~3.5k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Obsidian MarkdownAtmosphere/atmosphere | 3.8k | 20 repos | ~1.3k | Automated safety check: Pass | Apache-2.0 | |
| DOCXrvdbreemen/OTGW-firmware | 207 | 33 repos | ~4.3k | Automated safety check: Pass | Proprietary | |
| Word Document Reader and WriterHKUDS/DeepTutor | 41k | — | ~2.5k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Obsidian Markdown
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
DOCX
rvdbreemen/OTGW-firmware
A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).
Word Document Reader and Writer
HKUDS/DeepTutor
Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.
Crossposting
wasp-lang/wasp
Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.
More from HKUDS/CLI-Anything
All 78 skills in this repoCLI-Anything for Codex
HKUDS/CLI-Anything
Lets Codex build, refine, test, validate and list CLI-Anything harnesses for GUI applications or source repositories, following the project's full methodology.
CLI-Anything for Reasonix
HKUDS/CLI-Anything
Adapts the CLI-Anything methodology so Reasonix can build, refine, test and validate a command-line harness for an existing GUI application or source repository.
CLI-Anything for Hermes Agent
HKUDS/CLI-Anything
Guides Hermes Agent through building, refining and testing a CLI-Anything harness that wraps a GUI application or source repository in a scriptable command line.
CLI-Anything Harness Builder
HKUDS/CLI-Anything
Builds, refines, tests or validates a CLI-Anything harness that wraps a GUI application or source repository as a stateful Click CLI with JSON output and a REPL mode.
Krita CLI Harness
HKUDS/CLI-Anything
Drives Krita from the command line to create projects, add layers, apply filters, resize the canvas and export images, with JSON output for agents.
MacroCLI GUI Macros
HKUDS/CLI-Anything
Defines, lists, inspects and runs parameterized GUI macros from the command line, with the runtime choosing the execution backend.
Related
Categories
Questions about CLI Anything Calibre
What does CLI Anything Calibre do?
Command-line interface for Calibre - A stateful CLI harness for e-book library management, metadata editing, and format conversion wrapping the real Calibre tools (calibredb, ebook-convert…. CLI Anything Calibre is an agent skill from HKUDS/CLI-Anything. Command-line interface for Calibre - A stateful CLI harness for e-book library management, metadata editing, and format conversion wrapping the real Calibre tools (calibredb, ebook-convert, ebook-meta)...
When should I use CLI Anything Calibre?
CLI Anything Calibre fits situations like: documents & Office work in your project.
How do I install CLI Anything Calibre in Claude Code?
Run `npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a claude-code`. Or copy the skill folder (skills/cli-anything-calibre in HKUDS/CLI-Anything) into .claude/skills/cli-anything-calibre in your project. Claude Code loads it when a task matches its description.
How do I install CLI Anything Calibre in Codex?
Run `npx skills add HKUDS/CLI-Anything --skill cli-anything-calibre -a codex`. Or copy the skill folder (skills/cli-anything-calibre in HKUDS/CLI-Anything) into .agents/skills/cli-anything-calibre in your project. Codex loads it when a task matches its description.
Can I use CLI Anything Calibre 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 HKUDS/CLI-Anything --skill cli-anything-calibre -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cli-anything-calibre, .gemini/skills/cli-anything-calibre, .github/skills/cli-anything-calibre and .opencode/skills/cli-anything-calibre in your project.
What does CLI Anything Calibre need to run?
Going by SKILL.md and its folder, CLI Anything Calibre needs the command-line tools its instructions call (pip, apt-get and brew). Our summary lists: Python 3.
Does CLI Anything Calibre access the network?
SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is CLI Anything Calibre safe to install?
Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does CLI Anything Calibre use?
CLI Anything Calibre is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does CLI Anything Calibre use?
About 1.8k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to CLI Anything Calibre?
Skills that share tags, products or a category with CLI Anything Calibre: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains CLI Anything Calibre?
HKUDS (a GitHub organization) maintains it in HKUDS/CLI-Anything, which has 51,809 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on September 22, 2026.
Source: HKUDS/CLI-Anything on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.