How do I install the Audiobook Ingest skill?

Run npx skillmds add majiayu000/audiobook-ingest in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Audiobook Ingest safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Audiobook Ingest?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Audiobook Ingest free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Audiobook Ingest?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Audiobook Ingest by majiayu000 — Agent Skill

Name: Audiobook Ingest
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Audiobook Ingest (The Black Library)

Process and organize your audiobook collection. This skill uses uvx to run its tools, making it self-contained and portable.

Workflow

Sync/Download: Use uvx audible-cli to download books.
Decrypt: AAX/AAXC files are automatically decrypted using your Audible activation bytes.
Transcribe: Use uvx openai-whisper (Whisper CLI) to convert audio to text.
Organize: Moves files to ~/clawd/library/books/<Title>/.

Commands

`list-warhammer`

List all Warhammer 40k books in your Audible library (searches for Warhammer, Horus, Gaunt, Siege of Terra, etc.).

`download-warhammer`

Download ONLY your Warhammer 40k books. Perfect for building the Horus Lupercal voice model.

Exports your library
Finds all Warhammer-related books
Downloads each one in AAX format to the inbox (Audible's native format)

`download-all`

Download all books from your Audible library.

Downloads in AAX format (Audible's native encrypted format)

`ingest <filename>`

Process a single file from ~/clawd/library/inbox/.

Check if ~/clawd/library/inbox/<filename> exists.
Create directory ~/clawd/library/books/<filename_no_ext>.
If AAX/AAXC: Fetch activation bytes and decrypt to M4B using ffmpeg.
Run uvx --from openai-whisper whisper "<audio_file>" --model turbo --output_format txt --output_dir "~/clawd/library/books/<filename_no_ext>"
Move the audio file to ~/clawd/library/books/<filename_no_ext>/audio.<ext> (decrypted version for AAX/AAXC).
Rename output: mv "~/clawd/library/books/<filename_no_ext>/<filename>.txt" "~/clawd/library/books/<filename_no_ext>/text.md"

`ingest-all`

Process all audio files found in ~/clawd/library/inbox/.

List all .mp3, .m4a, .m4b, .wav, .aax, and .aaxc files in the inbox.
For each file, run the ingest workflow.

Setup & First Run

Audible Login: Ask Horus: "Help me log in to Audible" or run this manually:
```
uvx --from audible-cli audible quickstart
```
Follow the prompts to authorize.

Download Your Books:

# Download all Warhammer 40k books
./run.sh download-warhammer

# Or download everything
./run.sh download-all

Transcribe: Ask Horus: "Ingest all audiobooks" or "Process my library inbox".

Tips

Portable: Since this uses uvx, you don't need to manually install whisper or audible-cli. uv will download and cache them on first use.
Character Names: Whisper's turbo model is specifically great for the complex names found in Warhammer legends.

---name: audiobook-ingestdescription: Process audiobooks from the inbox: transcribe to text and organize audio for voice training.--- # Audiobook Ingest (The Black Library) Process and organize your audiobook collection. This skill uses `uvx` to run its tools, making it self-contained and portable. ## Workflow 1. **Sync/Download**: Use `uvx audible-cli` to download books. 2. **Decrypt**: AAX/AAXC files are automatically decrypted using your Audible activation bytes. 3. **Transcribe**: Use `uvx openai-whisper` (Whisper CLI) to convert audio to text. 4. **Organize**: Moves files to `~/clawd/library/books/<Title>/`. ## Commands ### `list-warhammer` List all Warhammer 40k books in your Audible library (searches for Warhammer, Horus, Gaunt, Siege of Terra, etc.). ### `download-warhammer` Download ONLY your Warhammer 40k books. Perfect for building the Horus Lupercal voice model. 1. Exports your library 2. Finds all Warhammer-related books 3. Downloads each one in AAX format to the inbox (Audible's native format) ### `download-all` Download all books from your Audible library. 1. Downloads in AAX format (Audible's native encrypted format) ### `ingest <filename>` Process a single file from `~/clawd/library/inbox/`. 1. Check if `~/clawd/library/inbox/<filename>` exists. 2. Create directory `~/clawd/library/books/<filename_no_ext>`. 3. If AAX/AAXC: Fetch activation bytes and decrypt to M4B using ffmpeg. 4. Run `uvx --from openai-whisper whisper "<audio_file>" --model turbo --output_format txt --output_dir "~/clawd/library/books/<filename_no_ext>"` 5. Move the audio file to `~/clawd/library/books/<filename_no_ext>/audio.<ext>` (decrypted version for AAX/AAXC). 6. Rename output: `mv "~/clawd/library/books/<filename_no_ext>/<filename>.txt" "~/clawd/library/books/<filename_no_ext>/text.md"` ### `ingest-all` Process all audio files found in `~/clawd/library/inbox/`. 1. List all `.mp3`, `.m4a`, `.m4b`, `.wav`, `.aax`, and `.aaxc` files in the inbox. 2. For each file, run the `ingest` workflow. ## Setup & First Run 1. **Audible Login**: Ask Horus: "Help me log in to Audible" or run this manually: ```bash uvx --from audible-cli audible quickstart ``` Follow the prompts to authorize. 2. **Download Your Books**: ```bash # Download all Warhammer 40k books ./run.sh download-warhammer # Or download everything ./run.sh download-all ``` 3. **Transcribe**: Ask Horus: "Ingest all audiobooks" or "Process my library inbox". ## Tips - **Portable**: Since this uses `uvx`, you don't need to manually install `whisper` or `audible-cli`. `uv` will download and cache them on first use. - **Character Names**: Whisper's `turbo` model is specifically great for the complex names found in Warhammer legends.

Frequently asked questions

Audiobook Ingest