---
name: "mobi-azw3-kindle-converter"
description: "Optimize and convert digital publications for Amazon Kindle devices using Calibre CLI."
metadata:
  author: "Kovid Goyal"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "convert epub to azw3 calibre"
  - "optimize ebook for kindle"
  - "embed cover image in mobi"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Kindle MOBI & AZW3 Ebook Optimizer

Converts EPUB and Markdown files into Amazon Kindle formats (AZW3, KFX, MOBI) using Calibre ebook-convert: typographic hyphenation, Kindle media queries, and cover image metadata.

## When to Invoke
Invoke this skill whenever you need to:
- convert epub to azw3 calibre
- optimize ebook for kindle
- embed cover image in mobi

## Execution SOP & Rules
1. Run ebook-convert input.epub output.azw3 --output-profile=kindle_paperwhite.
2. Embed cover image using --cover=cover.jpg to ensure display in Kindle library grids.
3. Apply CSS adjustments with --extra-css="p { text-indent: 1.5em; margin: 0; }" for e-ink readability.
4. Verify rendering fidelity using Kindle Previewer software before publishing.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.