@arturseo-geo/ebook-publishing-skillPublic

Skills#Claude Code#Writing #Marketing #Design

Claude Code skill for ebook and audiobook publishing

This skill gives Claude Code a publishing playbook for ebooks and audiobooks, from writing and formatting to distribution and launch. It combines a main `SKILL.md`, a project context file, and reference docs for platforms, cover specs, EPUB and PDF workflows, ISBN strategy, audiobooks, and promotion.

45 stars•10 forks•Updated 5mo ago

Who it's for

Builders who use Claude Code to self-publish books and want one place for the publishing workflow.

What it delivers

You can move from draft to distribution with fewer repeated prompts and a clearer publishing process.

What it does

Platform coverage

Covers 11 ebook, print, and audiobook platforms, with notes on manual steps and API or MCP support.

HTML to PDF workflow

Includes a Puppeteer screenshot-based HTML→PDF path, with notes about WeasyPrint and `page.pdf()` warnings.

Cover specs reference

Lists verified cover dimensions and DPI for platform and format combinations.

Audiobook guidance

Covers AI audiobook production, KDP Virtual Voice, ElevenLabs, ACX, and INaudio distribution.

ISBN strategy

Explains the KDP free ISBN tradeoff, buying your own ISBNs, and a KDP plus IngramSpark approach.

Promotion playbook

Includes permafree, BookBub eligibility, series pricing, read-through economics, and launch tactics.

How to get it

1Run

/plugin marketplace add YOUR_GITHUB_USERNAME/ebook-publishing-skill
/plugin install ebook-publishing@ebook-publishing-skill

2Run

git clone https://github.com/YOUR_GITHUB_USERNAME/ebook-publishing-skill.git ~/.claude/skills/ebook-publishing

3Run

npx skills add YOUR_GITHUB_USERNAME/ebook-publishing-skill

README

ebook-publishing-skill

Built by Artur Ferreira @ The GEO Lab · 𝕏 @TheGEO_Lab · LinkedIn · Reddit

The most comprehensive ebook and audiobook self-publishing skill for Claude Code. Covers the full lifecycle: write → format → convert → distribute → launch.

What Makes This the "Ultimate" Skill

Most publishing skills cover one thing — EPUB conversion, or KDP setup, or cover specs. This skill covers everything, including things no other skill addresses:

✅ HTML→PDF Puppeteer screenshot workflow (WeasyPrint/page.pdf() warnings included)
✅ Verified cover specs for 11 platform/format combinations with ratio and DPI
✅ AI audiobook production (ElevenLabs Studio, KDP Virtual Voice, distribution matrix)
✅ INaudio/Findaway Voices (rebranded August 2025) — wide audiobook distribution
✅ Google Play Books via PublishDrive
✅ ISBN strategy — the KDP free ISBN trap, buying your own, KDP+IngramSpark dual strategy
✅ IngramSpark 2026 update — upload fee removed, 1.875% Market Access Fee
✅ Permafree strategy and BookBub eligibility requirements
✅ Series pricing and read-through economics
✅ Gumroad MCP automation (rmarescu/gumroad-mcp)
✅ Python EPUB generation script (inspired by smerchek/claude-epub-skill, MIT)
✅ Full EPUB tool chain with Pandoc commands and epub-styles.css
✅ Platform MCP/API status for all platforms
✅ Production-tested — part of the The GEO Lab toolkit for AI-assisted content operations

Platforms Covered

Ebook Retailers

Platform	API/MCP
Amazon KDP	❌ Manual
Apple Books	❌ Manual
Kobo Writing Life	❌ Manual
Barnes & Noble Press	❌ Manual
Google Play Books	❌ Manual (via PublishDrive)
Gumroad	✅ `rmarescu/gumroad-mcp`
Payhip	❌ Manual

Aggregators

Platform	Reaches
Draft2Digital	Amazon, Apple, Kobo, B&N, Scribd, Tolino, libraries
PublishDrive	400+ stores, 240k libraries, Google Play, international
StreetLib	Europe, Latin America, Middle East, Africa

Print-on-Demand

Platform	Best for
KDP Print	Amazon marketplace
IngramSpark	Bookstores, libraries, hardcovers
Bookvault	UK/Europe print

Audiobook Distribution

Platform	Notes
ACX	Amazon/Audible — human narration preferred
INaudio (formerly Findaway Voices)	Wide — Spotify, Apple, Google, 30+ platforms
PublishDrive Audio	50 distribution partners
KDP Virtual Voice	Amazon AI narration (US beta)
ElevenLabs	Production tool + ElevenReader distribution

Install

Via Claude Code plugin marketplace

/plugin marketplace add YOUR_GITHUB_USERNAME/ebook-publishing-skill
/plugin install ebook-publishing@ebook-publishing-skill

Manual install

git clone https://github.com/YOUR_GITHUB_USERNAME/ebook-publishing-skill.git ~/.claude/skills/ebook-publishing

Via skills CLI

npx skills add YOUR_GITHUB_USERNAME/ebook-publishing-skill

File Structure

ebook-publishing/
├── SKILL.md                        # Main skill — always loaded (~100 tokens)
├── project-context.md              # Your brand + publishing setup (edit this)
└── references/
    ├── platforms.md                # All platforms, royalties, API status (2026)
    ├── cover-specs.md              # Verified cover dimensions for 11 platforms
    ├── formatting.md               # EPUB tool chain, HTML→PDF, Pandoc, Python script
    ├── audiobooks.md               # ACX, ElevenLabs, KDP VV, INaudio, distribution matrix
    ├── isbn-strategy.md            # ISBN buying guide, KDP trap, KDP+IS dual strategy
    └── promotion.md                # BookBub, permafree, series, ARC, launch playbook

Contributing

Platform specs change constantly — royalties shift, fees change, new platforms emerge. PRs with sourced updates are always welcome.

See CONTRIBUTING.md for guidelines. Use the issue templates for:

Attributions & Licence

Built and maintained by Artur Ferreira · Part of the The GEO Lab toolkit.

Best Practice Attribution

This skill was built following the open source Best Practice Approach — reading community work for inspiration, then writing original content, and crediting every source.

Based on:

Agent Skills specification by Anthropic (Apache 2.0)

Inspired by community repos researched during development:

smerchek/claude-epub-skill — Markdown→EPUB3 conversion with Python (MIT) — Python script pattern in references/formatting.md
coreyhaines31/marketingskills — marketing skill patterns (MIT)
alirezarezvani/claude-skills — skill structure conventions (MIT)
ThomasHoussin/Claude-Book — multi-agent fiction writing with EPUB/MOBI build

Platform data compiled from official documentation:

Amazon KDP, Apple Books, Kobo Writing Life, Gumroad, Payhip, Draft2Digital, B&N Press, IngramSpark, Google Play Books, PublishDrive, StreetLib
Audiobook sources: ElevenLabs, INaudio (formerly Findaway Voices), ACX, KDP Virtual Voice
Industry sources: Reedsy, ALLi (Alliance of Independent Authors), IngramSpark Blog, selfpublishing.com

All skill content is original writing. No files were copied or adapted from any source. MIT licence.

Found this useful? ⭐ Star the repo and connect: 🌐 thegeolab.net · 𝕏 @TheGEO_Lab · LinkedIn · Reddit

Changelog

v2.0.0 (March 2026) — The Ultimate Edition

Added:

Complete audiobook reference — ElevenLabs Studio workflow, KDP Virtual Voice (US beta), INaudio/Findaway Voices (rebranded Aug 2025), AI narration distribution matrix
ISBN strategy reference — the KDP free ISBN trap, buy your own (Bowker/Nielsen), KDP+IngramSpark dual publish strategy
Promotion & launch reference — permafree mechanics, BookBub eligibility, series read-through economics, ARC strategy, email list building from back matter
Google Play Books, PublishDrive (400+ stores), StreetLib platforms
IngramSpark 2026 update — upload fee removed, 1.875% Market Access Fee
Python EPUB generation script (inspired by smerchek/claude-epub-skill, MIT)
EPUB CSS template (epub-styles.css)
Kindle Unlimited KENPC mechanics

Updated:

Cover specs expanded to 11 platform/format combinations
Platforms reference restructured with aggregators and POD as separate sections
Royalty calculator updated for all platforms

v1.1.0 (March 2026)

Added HTML→PDF Puppeteer screenshot workflow (6-step, with WeasyPrint/page.pdf() warnings)
Updated cover specs to 9 platforms with ratio and DPI columns
Added Gumroad MCP documentation (rmarescu/gumroad-mcp)
Added platform API/MCP status table for all platforms
Added DPI requirements table by output type
Added interactive elements strategy for designed ebooks

v1.0.0 (March 2026) — Initial release

Core skill built from scratch following the Agent Skills specification. Covers: book structure, EPUB formatting, cover design, metadata, pricing, launch strategy. Platforms: Amazon KDP, Apple Books, Gumroad, Payhip, Draft2Digital, Kobo, B&N Press, IngramSpark.

Licence

MIT — see LICENSE

Built and maintained by Artur Ferreira · Part of the The GEO Lab toolkit · MIT License

Files in the repo

Repository payload•8 top-level entries

references— 6 items
.gitignore
CONTRIBUTING.md
LICENSE— License
project-context.md— Editable project context for the author or publishing setup.
README.md— The README
SECURITY.md
SKILL.md— Main skill file that Claude Code loads.

Discussion (0)

Ask about usage, or say what you built with it

No comments yet. Be the first to say what this is good for.

More skills

Vincentwei1021/

anything2explainer

Vincentwei1021/anything2explainerSkills

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

anthropics/skillsSkills

Public repository for Agent Skills

176k

career-ops-hq/career-opsSkills

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k

nextlevelbuilder/ui-ux-pro-max-skillSkills

An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.

127k

Leonxlnx/taste-skillSkills

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

86k

tt-a1i/archifySkills

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k