playbooks

home / skills / d-oit / do-novelist-ai / publishing

publishing skill

/.opencode/skill/publishing

This skill helps you implement EPUB generation, cover art, and export workflows for publishing platforms with compliant, user-friendly outputs.

npx playbooks add skill d-oit/do-novelist-ai --skill publishing

Review the files below or copy the command above to add this skill to your agents.

Files (7)
SKILL.md
2.3 KB
---
name: publishing
description:
  Work on publishing features including EPUB generation, cover image generation,
  platform integration, and export functionality. Use when implementing eBook
  creation, platform exports, or distribution workflows.
---

# Publishing

## Quick Reference

- **[EPUB Generation](epub-generation.md)** - eBook creation and formatting
- **[Cover Generation](cover-generation.md)** - Image creation and styling
- **[Platform Integration](platform-integration.md)** - Amazon KDP, Google Play,
  etc.
- **[Export Workflows](export-workflows.md)** - Export and submission processes

## When to Use

- Implementing EPUB 3.0 generation
- Building cover image generation systems
- Creating platform-specific export workflows
- Working on metadata management
- Implementing submission automation
- Handling publishing standards compliance

## Core Methodology

- **Standards Compliance**: Follow EPUB 3.0, IDPF, and platform guidelines
- **Asset Management**: Handle images, fonts, and styles efficiently
- **Platform Rules**: Implement Amazon KDP, Google Play, and platform-specific
  requirements
- **Error Handling**: Validate exports before submission
- **User Experience**: Provide clear feedback and progress tracking

## Integration

- **tech-stack-specialist**: Manage EPUB libraries (JSZip, etc.)
- **qa-engineer**: Test export functionality and platform compliance
- **performance-engineer**: Optimize large file generation
- **architecture-guardian**: Maintain clean separation of publishing logic
- **domain-expert**: Model publishing domain concepts

## Best Practices

✓ Validate all exports before submission ✓ Support multiple output formats
(EPUB, PDF, etc.) ✓ Provide detailed error messages for failed exports ✓
Optimize image compression without quality loss ✓ Include comprehensive metadata

## Content Modules

See detailed modules:

- **[EPUB Generation](epub-generation.md)**: EPUB 3.0 creation, metadata, and
  styling
- **[Cover Generation](cover-generation.md)**: AI image generation and style
  presets
- **[Platform Integration](platform-integration.md)**: Platform-specific exports
  and submissions
- **[Export Workflows](export-workflows.md)**: Export pipelines and automation
- **[Publishing Standards](standards.md)**: Compliance and best practices

Overview

This skill focuses on publishing features for eBook workflows, including EPUB generation, cover image creation, platform integration, and export automation. It provides practical tools and patterns to produce standards-compliant outputs and streamline distribution. The goal is reliable, testable publishing pipelines that handle metadata, assets, and platform requirements.

How this skill works

The skill inspects content, assets, and metadata to assemble EPUB 3.0 packages, generate optimized cover images, and produce other output formats like PDF. It validates exports against standards and platform rules, compresses and manages images and fonts, and emits detailed error reports. Integration adapters automate submissions to platforms such as Amazon KDP and Google Play, and export workflows support retries, logging, and progress tracking.

When to use it

  • Implement EPUB 3.0 or other eBook generation features
  • Build automated cover image generation and styling pipelines
  • Create platform-specific export and submission workflows
  • Automate metadata handling and validation before distribution
  • Optimize large-file exports and improve publishing performance

Best practices

  • Validate exports against EPUB and platform specifications before submission
  • Keep publishing logic modular to separate asset handling, packaging, and submission
  • Support multiple output formats and provide fallbacks for platform constraints
  • Compress images intelligently to balance quality and file size
  • Provide clear, actionable error messages and progress feedback to users
  • Automate tests for compliance and end-to-end export scenarios

Example use cases

  • Create an EPUB generator that assembles chapters, embeds fonts, and produces a validated .epub file
  • Generate cover images from templates or AI models and export multiple size variants for platforms
  • Implement an adapter to submit books to Amazon KDP and handle platform-specific metadata transformations
  • Build an export pipeline that produces EPUB and PDF, runs validation, and uploads artifacts to a content delivery system
  • Automate batch submissions with retry logic, logging, and compliance checks for multiple titles

FAQ

Which standards does this skill target?

It targets EPUB 3.0 and related IDPF guidelines, plus common platform requirements for Amazon KDP, Google Play, and similar stores.

How does validation work?

Validation runs automated checks on package structure, metadata, and assets, reporting errors and warnings before submission so issues can be fixed proactively.