KDP Book Publishing Workflow

Orchestrate the full workflow for publishing a book through Amazon KDP (Kindle Direct Publishing): audit the manuscript, craft the listing, prepare files, and submit. This skill coordinates /kdp-audit and /kdp-listing into a phased pipeline, then walks through the mechanical submission steps on the KDP dashboard.

Strategy

The recommended publication sequence:

1. •Audit -- Verify the manuscript meets KDP formatting and content requirements
2. •Listing -- Craft blurb, keywords, categories, and author bio (the marketing artifacts that determine discoverability)
3. •Prepare -- Convert manuscript to final format, verify cover specs
4. •Submit -- Walk through the KDP dashboard, upload files, set pricing, publish

Each phase gates the next. Do not submit a manuscript that fails audit. Do not fill in listing fields without the artifacts from /kdp-listing. Present the phase map, confirm the plan, and proceed one phase at a time.

Workflow

Phase 1: Assess Current State

Determine where the book stands in the pipeline to skip completed phases.

Load user config (Read tool): Read .claude/pub-pipeline.local.md if it exists. Extract the kdp section and author metadata from YAML frontmatter. If the file is missing, offer to create one from the template at ${CLAUDE_PLUGIN_ROOT}/docs/user-config-template.md.

Detect manuscript files (Glob tool): Search for manuscript files in the project:

• •.tex files (LaTeX -- technical books)
• •.docx files (Word -- fiction/nonfiction)
• •.epub files (eBook source)
• •.md files (Markdown manuscripts)
• •.pdf files (final output)
• •.kpf files (Kindle Create project)

Classify the manuscript type: Technical (LaTeX, math, code), Fiction (chapters, dialog), or General nonfiction.

Check what already exists (Glob/Read tools):

• •Cover files? (cover*.jpg, cover*.pdf, paperback-cover.*, full-cover.*)
• •Audit already done? (Look for recent audit report in conversation history or notes)
• •Listing artifacts in config? (kdp.blurb, kdp.keywords, kdp.categories populated?)
• •Manuscript in final format? (compiled PDF, validated EPUB)

Present status table to the user summarizing findings.

Decision matrix -- determine where to enter the pipeline:

Present the recommended plan and confirm with the user before proceeding.

Phase 2: Audit

Run /kdp-audit to evaluate the manuscript against KDP requirements.

The audit checks interior formatting, cover specs, metadata completeness, and genre-specific requirements. It produces a structured gap report with Critical / Warnings / Passed sections.

If critical gaps are found:

1. •Present the gap report to the user
2. •Offer to fix automatable issues (margins, missing front matter, scene break markers)
3. •Guide manual fixes (cover creation, content revisions)
4. •Re-audit after fixes

Gate: The manuscript must pass audit (no critical gaps) before proceeding to Phase 3. Warnings are acceptable but should be noted for later attention.

Phase 3: Craft Listing

Run /kdp-listing to generate the four marketing artifacts:

• •Blurb (book description, max 4000 characters with HTML formatting)
• •Keywords (7 keyword phrases for Amazon search)
• •BISAC categories (2-3 browse categories)
• •Author bio (for the product page and Author Central)

The listing skill reads manuscript context, generates drafts, iterates with the user, and saves all artifacts to .claude/pub-pipeline.local.md.

Gate: All four artifacts must be saved to the config before proceeding. Phase 7 reads them during dashboard submission.

Phase 4: Pre-Order Setup (Optional)

Ask the user whether they want to set up a pre-order before the book is finalized.

When pre-orders make sense: Fiction launches where Day 1 ranking matters (pre-orders count toward release-day sales rank), books with an existing audience, or series releases.

Pre-order mechanics:

• •Available up to 90 days before publication date
• •Upload a placeholder or final manuscript; set publication date and price
• •Final manuscript must be uploaded at least 72 hours before publication date
• •Missing the 72-hour deadline may result in KDP blocking pre-order privileges for one year

How to set up: Create the title on KDP dashboard (see Phase 7), choose "Make this book available for pre-order," set the release date, upload manuscript, and complete pricing (Phase 8).

If not using pre-orders, skip to Phase 5.

Phase 5: Manuscript Preparation

Ensure the manuscript is in final publishable form.

Format conversion (Bash tool):

• •LaTeX to PDF: Run pdflatex (multiple passes for cross-references; add bibtex pass if bibliography exists). Verify fonts embedded, margins correct, page numbers start after front matter.
• •Markdown to EPUB: Use pandoc manuscript.md -o manuscript.epub --toc. Validate with epubcheck if available.
• •DOCX to PDF: Use libreoffice --headless --convert-to pdf or Word's built-in PDF export with fonts embedded.

Final proofread checklist:

• • Front matter complete (title page, copyright, dedication, TOC)
• • Chapter headings consistent in style
• • Page numbers start after front matter
• • All images/figures embedded and captioned
• • Bibliography/references formatted correctly (if applicable)
• • Back matter complete (acknowledgments, About the Author)
• • No orphan blank pages

Phase 6: Cover Preparation

Verify cover files meet KDP specifications. See ${CLAUDE_PLUGIN_ROOT}/docs/kdp-reference.md for full cover requirements (dimensions, DPI, spine width calculation, bleed).

Quick checks:

• •eBook cover: minimum 2560x1600 pixels, 1.6:1 aspect ratio, JPEG or TIFF, under 50MB
• •Paperback cover: 300 DPI minimum, full wraparound PDF with bleed (0.125" each side)

Verify dimensions (Bash tool): Use identify -format "%wx%h" cover.jpg (ImageMagick) or file cover.jpg to check actual dimensions.

Direct the user to the KDP Cover Calculator: https://kdp.amazon.com/en_US/cover-calculator

If cover files do not exist, pause and recommend hiring a designer or using KDP Cover Creator.

Phase 7: KDP Dashboard Submission

Walk the user through the KDP dashboard "Create a New Title" process. This phase reads listing artifacts from the config (populated by /kdp-listing in Phase 3).

KDP Account Setup (first-time publishers only): Complete account setup at https://kdp.amazon.com — tax interview, bank details, email verification. See ${CLAUDE_PLUGIN_ROOT}/docs/kdp-reference.md for the account setup walkthrough.

Book Details (step through dashboard fields):

1. •

   Language and Title: Select language. Enter title (max 200 chars), subtitle (optional), series name and number (if applicable), edition number (if revised edition).

2. •

   Author and Contributors: Use kdp.pen_name from config (or author.name if no pen name). Add co-authors, editors, illustrators, translators as contributors.

3. •

   Description: Paste the blurb from kdp.blurb in the config. Verify HTML formatting renders correctly in the preview. If kdp.blurb is empty, stop and run /kdp-listing first.

4. •

   Publishing Rights: Ask the user:

   • •"I own the copyright" (original works)
   • •"This is a public domain work" (classics, expired copyright)
   • •Rights holder confirmation (licensed content)
5. •

   Keywords: Enter the 7 keywords from kdp.keywords in the config. If empty, stop and run /kdp-listing first.

6. •

   Categories: Select the BISAC categories from kdp.categories in the config. If empty, stop and run /kdp-listing first.

7. •

   Age and Grade Range: Required for children's books. Optional for YA (select 12-18). Skip for adult books.

8. •

   Upload Manuscript: eBook accepts EPUB, DOCX, or PDF. Paperback accepts PDF only (PDF/X-1a:2001 recommended). Wait for conversion (30 seconds to 5 minutes).

9. •

   Upload Cover: eBook: single front cover image (JPEG/TIFF). Paperback: full wraparound cover PDF or use KDP Cover Creator.

10. •

    KDP Previewer: Review the book in Kindle, tablet, and phone views. Check for text overflow, broken images, TOC links, page breaks, extra blank pages, and font substitution.

Multi-format coordination (if publishing both eBook and paperback):

• •Create the eBook first, then add paperback as a linked format (shared product page, reviews, "Look Inside")
• •Metadata must match exactly across formats; cover files differ (front-only for eBook, full wrap for paperback)

Phase 8: Pricing

Interactive decisions made during the workflow, not pre-populated from config.

eBook royalty tiers:

• •70% royalty: Price must be $2.99-$9.99. Delivery cost deducted (~$0.10-$0.30 per download based on file size). Best for most books.
• •35% royalty: Any price $0.99+. No delivery cost. Use for short works, loss leaders, or prices outside the $2.99-$9.99 range.

KDP Select enrollment:

• •Exclusive to Amazon for 90 days (auto-renews). Cannot sell eBook on other platforms during enrollment.
• •Benefits: Kindle Unlimited (readers borrow, author earns per page read), Kindle Countdown Deals, Free Book Promotions.
• •Trade-off: No wide distribution (Apple Books, Kobo, Barnes & Noble). Good for debut authors building readership on Amazon. Not ideal with existing sales channels elsewhere.

Genre-aware price recommendations: See ${CLAUDE_PLUGIN_ROOT}/docs/kdp-reference.md for genre-specific price ranges, paperback printing cost calculations, and royalty examples.

Territories: Choose "Worldwide rights" if the author holds global rights, or select specific countries.

Phase 9: Publish

Final review checklist:

• • All metadata correct (title, author, description, keywords, categories)
• • Pricing set for all territories
• • Preview reviewed and approved
• • ISBN decision made (KDP-assigned or a provided ISBN)

Submit for review:

• •Click "Publish Kindle eBook" or "Approve Proof" (paperback)
• •Review timeline: 24-72 hours for eBooks, up to 5 business days for paperbacks
• •Email notification when the book goes live

For paperback: Strongly recommend ordering a proof copy before approving ($5-$10 including shipping). Check print quality, margins, spine alignment, and color accuracy. Proofs can be ordered without publishing.

Phase 10: Post-Publish

After KDP approves the book:

1. •Verify listing: Search Amazon for the book by title or ASIN/ISBN. Check "Look Inside" preview, category placement, keyword discoverability, and "Buy" button.
2. •Author Central setup: Claim the author page at https://authorcentral.amazon.com, add photo and bio from config.
3. •Goodreads linking (optional): Claim the book, connect author profile.
4. •A+ Content (if eligible): Add rich media to the product page.
5. •Launch promotions (KDP Select only): Kindle Countdown Deals, Free Book Promotions.
6. •Ongoing monitoring: Check KDP sales dashboard for sales, royalties, page reads, and rankings.

See ${CLAUDE_PLUGIN_ROOT}/docs/kdp-reference.md for detailed post-publication steps including Author Central, A+ Content, and launch promotion strategies.

Reference Files

For complete KDP requirements, formatting guidelines, and exemplar listings:

• •${CLAUDE_PLUGIN_ROOT}/docs/kdp-reference.md -- Full KDP formatting requirements, cover templates, metadata guidelines, submission checklist, and pricing calculator reference
• •${CLAUDE_PLUGIN_ROOT}/docs/kdp-exemplars.md -- Blurb examples by genre, keyword strategies, category selection tactics, author bio conventions
• •${CLAUDE_PLUGIN_ROOT}/docs/user-config-template.md -- Template for .claude/pub-pipeline.local.md user config file

Important Notes

• •Run /kdp-audit or /kdp-listing independently for a specific step without the full pipeline.
• •KDP Select is a 90-day exclusive commitment -- the eBook cannot be sold on other platforms during enrollment.
• •KDP is free to use. Amazon takes a percentage via the royalty split (30% or 65% depending on tier).
• •Royalties are paid monthly, ~60 days after month-end. Minimum threshold: $100 (direct deposit).
• •Paperbacks are print-on-demand. No inventory, no upfront printing costs.
• •ISBN is not required. KDP provides a free ASIN for eBooks and a free ISBN for paperbacks. A custom ISBN is useful for distribution beyond Amazon.
• •Manuscript updates post-publication take 24-72 hours to propagate.