# Book Illustrate

> Generate interior illustrations for book chapters. Analyzes scenes, creates style-consistent illustration prompts, and produces illustration plan with placement metadata.

- **Type:** Skill
- **Install:** `agentstack add skill-epicsagas-velith-book-illustrate`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [epicsagas](https://agentstack.voostack.com/s/epicsagas)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [epicsagas](https://github.com/epicsagas)
- **Source:** https://github.com/epicsagas/Velith/tree/main/skills/book-illustrate

## Install

```sh
agentstack add skill-epicsagas-velith-book-illustrate
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Interior Illustration Pipeline

Orchestrates the illustration generation process for book chapters.

## Prerequisites

- Project must have `PRD.md` and at least one chapter draft in `drafts/`
- `STYLE.md` should exist for art direction (falls back to genre defaults if missing)

## Pipeline

### Step 1: Generate Illustration Plan

Invoke the `illustrator` agent:

```
Read the book's PRD.md, STYLE.md, outline.md, and all chapter drafts in drafts/.
For each chapter, identify 2-4 key visual moments suitable for illustration.
Generate style-consistent illustration prompts with a reusable style seed.
Output the complete plan to publish/illustrations/plan.md and manifest.json.
```

The agent will:
1. Read STYLE.md for art direction (or infer from genre)
2. Scan each chapter for illustration-worthy scenes
3. Create a style seed prompt for consistency
4. Generate prompts for each scene in multiple tiers
5. Write the plan and manifest

### Step 2: Review Plan

Present the illustration plan to the user for review:
- Total illustration count
- Per-chapter distribution
- Style seed summary
- Key scenes selected

Ask the user to approve, modify scene selections, or adjust the style direction.

### Step 3: Execute (Optional — requires image generation tools)

If image generation MCP tools are available (claude-image-gen, Replicate, etc.):
- Generate images using the prompts from the plan
- Save to `publish/illustrations/ch{NN}-{scene-slug}.jpg`
- Optimize file sizes (compress to <500KB for EPUB compatibility)

If no image generation tools are available:
- The plan.md serves as the executable spec
- User can use the prompts in Midjourney, DALL-E, Stable Diffusion, or any external tool
- Place generated images in `publish/illustrations/` following the naming convention

### Step 4: Integration

Insert illustration references into chapter drafts:

```markdown

```

Placement rules:
- `chapter-header`: After the chapter title heading
- `full-page`: On its own line, between paragraphs at the scene location
- `inline`: Within the paragraph flow
- `spot`: As a decorative element at section breaks

## Output Structure

```
publish/illustrations/
├── plan.md                    # Illustration plan with prompts
├── manifest.json              # Machine-readable summary
├── ch01-opening-scene.jpg     # Generated images (if executed)
├── ch01-climax.jpg
├── ch02-meeting.jpg
└── ...
```

## EPUB Compatibility

- All images: JPEG format, RGB, sRGB color space
- Target: <500KB per image for reasonable EPUB file size
- Recommended dimensions: 800x1200px (full-page), 1600x533px (header), 600x600px (inline/spot)
- pandoc automatically embeds images referenced in markdown

## Post-Completion

Update the project dashboard status:

```bash
node {PLUGIN_ROOT}/skills/book-status/scripts/scan-project.js [project-dir] --plugin-root={PLUGIN_ROOT}
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [epicsagas](https://github.com/epicsagas)
- **Source:** [epicsagas/Velith](https://github.com/epicsagas/Velith)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-epicsagas-velith-book-illustrate
- Seller: https://agentstack.voostack.com/s/epicsagas
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.