Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

audiobook

verified

Convert book chapters from Calibre library to audiobook (MP3) using Google Gemini TTS via Vertex AI. High-quality audiobook narration with professional voice prompts.

View on GitHub

Marketplace

albo-plugins

misteral/claude_plugins

Plugin

audiobook-plugin

Repository

misteral/claude_plugins

plugins/audiobook-plugin/skills/audiobook/SKILL.md

Last Verified

February 4, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/misteral/claude_plugins/blob/main/plugins/audiobook-plugin/skills/audiobook/SKILL.md -a claude-code --skill audiobook

Installation paths:

Claude
.claude/skills/audiobook/
Powered by add-skill CLI

Instructions

# Audiobook Creator Skill

Converts specific chapters from books in your Calibre library to MP3 audiobooks using Google Gemini TTS.

## Example Commands

- `/audiobook 7 и 8 главу книги Убийства и кексики`
- `/audiobook chapters 1-3 of "The Great Gatsby"`
- `/audiobook главы 5, 6, 7 книги "Война и мир"`

## Configuration

**Calibre Library Path:** `/Users/aleksandrbobrov/Library/Mobile Documents/com~apple~CloudDocs/CalibreLib`

**Scripts Directory:** `scripts/` (relative to this SKILL.md)

## Workflow

### Step 1: Parse User Request

Extract:
- **Book title**: e.g., "Убийства и кексики"
- **Chapters**: e.g., "7 и 8" → chapters 7, 8

Chapter formats:
- `главу 7` / `chapter 7` → single chapter
- `главы 7 и 8` / `chapters 7 and 8` → multiple
- `главы 1-5` / `chapters 1-5` → range
- `главы 1, 3, 5` → specific list

### Step 2: Find Book in Calibre

```bash
CALIBRE_LIB="/Users/aleksandrbobrov/Library/Mobile Documents/com~apple~CloudDocs/CalibreLib"
calibredb list --library-path "$CALIBRE_LIB" --search "title:~<book_title>" -f title,authors,formats --for-machine
```

Get book ID from results.

### Step 3: Export and Convert

```bash
WORK_DIR=$(mktemp -d)
calibredb export <BOOK_ID> --library-path "$CALIBRE_LIB" --to-dir="$WORK_DIR" --single-dir --dont-write-opf --dont-save-cover --formats=epub,fb2

# Convert to text
BOOK_FILE=$(ls "$WORK_DIR"/*.{epub,fb2,mobi} 2>/dev/null | head -1)
ebook-convert "$BOOK_FILE" "$WORK_DIR/book.txt"
```

### Step 4: Extract Chapters

```bash
SCRIPTS_DIR="<path-to-this-skill>/scripts"
uv run --project "$SCRIPTS_DIR" python "$SCRIPTS_DIR/extract_chapters.py" \
  "$WORK_DIR/book.txt" \
  --chapters 7,8 \
  --output "$WORK_DIR/chapters.md"
```

To list chapters first:
```bash
uv run --project "$SCRIPTS_DIR" python "$SCRIPTS_DIR/extract_chapters.py" "$WORK_DIR/book.txt" --list
```

### Step 5: Convert to Audiobook

```bash
uv run --project "$SCRIPTS_DIR" python "$SCRIPTS_DIR/md_to_audiobook.py" \
  "$WORK_DIR/chapters.md" \
  --output ~/Downloads/

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2645 chars