← 返回 Skills 市场
209
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install calibre-convert
功能描述
Use this skill when the user wants to convert ebook or document files between formats with Calibre, including EPUB to PDF, Markdown to EPUB, MOBI to EPUB, AZ...
使用说明 (SKILL.md)
Calibre Convert
Overview
calibre-convert uses Calibre's ebook-convert CLI to perform ebook and document format conversion. Use it when the user wants a direct file-to-file conversion and the desired input/output formats are supported by Calibre.
Quick Start
- Confirm the source file exists and decide the exact output path.
- Check whether
ebook-convertis available inPATH. - Run the helper script:
./scripts/convert_with_calibre.py /path/to/input.epub /path/to/output.pdf
- If the user wants format-specific tuning, pass Calibre arguments after
--:
./scripts/convert_with_calibre.py /path/to/book.md /path/to/book.epub -- --chapter "//h:h1" --authors "Example Author"
Workflow
1. Validate inputs
- Ensure the input file exists.
- Ensure the output directory exists or create it if the task allows edits there.
- Infer the requested conversion from the output extension when the user says things like "convert EPUB to PDF".
2. Check Calibre availability
Use the bundled script first. It looks for ebook-convert in PATH, then common macOS install locations.
If Calibre is missing, stop and tell the user exactly which command is missing. Do not pretend the conversion succeeded.
3. Run conversion
The core command is:
ebook-convert input_file output_file [options...]
Common examples:
- EPUB -> PDF
- Markdown -> EPUB
- MOBI -> EPUB
- AZW3 -> EPUB
- HTML -> EPUB
- DOCX -> EPUB
When the user does not specify extra options, prefer the simplest possible conversion.
4. Verify result
- Confirm the output file was created.
- Report the final path back to the user.
- If Calibre emits warnings, summarize only the meaningful parts.
Notes
- Calibre support varies by format pair and by installed version.
- PDF output quality depends heavily on source structure and metadata.
- Markdown input is handled by Calibre's parsers; if the output looks poor, try converting via HTML or adding explicit options.
- For large batches, loop over files and keep source/target extensions explicit instead of guessing.
Resources
scripts/
scripts/convert_with_calibre.py: validates paths, findsebook-convert, and forwards extra options safely.
references/
references/examples.md: ready-to-copy conversion examples and troubleshooting notes.
安全使用建议
This skill is a simple wrapper for Calibre's ebook-convert. Before installing, ensure you have Calibre (ebook-convert) installed and reachable on PATH (or at one of the macOS paths the script checks). Note the registry metadata doesn't declare the required binary—so the agent will fail if ebook-convert is not present. The script does not auto-create missing output directories (it will return an error), and it runs the external ebook-convert binary without using a shell (no shell injection risk in the wrapper). Because the agent can invoke the skill implicitly, only install it if you are comfortable letting the agent run local conversion commands when asked.
功能分析
Type: OpenClaw Skill
Name: calibre-convert
Version: 1.0.0
The skill bundle provides a legitimate utility for converting ebook formats using the Calibre 'ebook-convert' CLI. The core logic in 'scripts/convert_with_calibre.py' uses safe subprocess execution practices (passing arguments as a list) and includes basic path validation, with no evidence of malicious intent, data exfiltration, or prompt injection attacks.
能力评估
Purpose & Capability
The skill's name, description, SKILL.md, and script all align: they wrap Calibre's ebook-convert to convert files. Minor metadata mismatch: the registry lists no required binaries while the runtime clearly depends on the ebook-convert binary being installed and reachable.
Instruction Scope
SKILL.md instructs the agent to validate input/output paths, check for ebook-convert, run the bundled script, and verify output. The included script implements those steps and does not access unrelated files, environment variables, or external endpoints.
Install Mechanism
There is no install spec and no network downloads; the skill is instruction-plus-local-script only. Nothing is written to disk by an installer beyond the shipped files.
Credentials
No credentials, environment variables, or config paths are requested. The script does not attempt to read or exfiltrate secrets.
Persistence & Privilege
The skill is not always-enabled and uses normal implicit invocation. It does not modify other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install calibre-convert - 安装完成后，直接呼叫该 Skill 的名称或使用
/calibre-convert触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of calibre-convert skill for converting ebook and document files between formats using Calibre’s `ebook-convert` CLI.
- Supports common conversions such as EPUB to PDF, Markdown to EPUB, MOBI to EPUB, AZW3 to EPUB, HTML to EPUB, and DOCX to EPUB.
- Provides a helper script (`convert_with_calibre.py`) for path validation and safe CLI argument forwarding.
- Includes clear workflow for input validation, Calibre availability check, file conversion, and result verification.
- Offers documentation with usage examples, troubleshooting notes, and a resources section for further guidance.
元数据
常见问题
calibre-convert 是什么？
Use this skill when the user wants to convert ebook or document files between formats with Calibre, including EPUB to PDF, Markdown to EPUB, MOBI to EPUB, AZ... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 209 次。
如何安装 calibre-convert？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install calibre-convert」即可一键安装，无需额外配置。
calibre-convert 是免费的吗？
是的，calibre-convert 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
calibre-convert 支持哪些平台？
calibre-convert 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 calibre-convert？
由 shake（@shake）开发并维护，当前版本 v1.0.0。
推荐 Skills