Content PDF With Images Workflow

This is an orchestration skill. It does not replace planning, image, or PDF skills. It forces a staged handoff so the final artifact is a real PDF with real image inputs, not a placeholder file.

Before generating, extending, repairing, or repainting chapter images, read ../../marketplace/pdf/editable-reconstruction.md only for its provider order. Generate the chapter image that best fits the intended composition; do not force a text-free background or separate PDF text layer for ordinary illustrations.

Only when the user explicitly requests editable reconstruction of a scanned, flattened, or image-only PDF, apply the complete per-page contract from that reference: one text-free full-page PNG plus native selectable PDF text objects.

Hard rule: image prompts are not images. A PDF that contains only chapter text and image prompts is incomplete and must not be reported as delivered.

Output Contract

Final deliverables must stay inside the current XWorkmate/OpenClaw task artifact scope:

• workflow.plan.md
• article.md
• assets/images/*.png
• assets/images/manifest.md
• prompts/image-prompts.md
• series.config.json
• exports/final.pdf
• DELIVERY.md

If the user specifies a particular content sequence or evolutionary path, ensure the exact sequence is preserved. Do not hardcode a fixed number of chapters unless requested.

Phase 1: Plan

Create workflow.plan.md before writing final content. It must include:

• topic and audience
• chapter list
• target word or character count
• one image concept per chapter
• downstream skill sequence
• final acceptance checklist

If the user gives an explicit chapter sequence, preserve it literally.

Phase 2: Article

Write article.md with:

• title
• one section per planned chapter
• concise intro and closing summary
• total length matching the user request

Do not claim completion after this phase.

Phase 3: Images

Use the image-series skill path for one standalone PNG per chapter.

If an image-generation tool is available, call it for each chapter before PDF assembly. If no image-generation tool is available, stop after article.md and prompts/image-prompts.md, then report that the PDF cannot be completed because the required image artifacts are missing.

Required checks before continuing:

• PNG count equals chapter count.
• Every assets/images/*.png is a real non-empty PNG.
• Every chapter image is a generated or user-provided bitmap image, not a text placeholder, blank rectangle, SVG prompt card, or decorative filler.
• assets/images/manifest.md exists and references only relative paths inside the artifact scope.
• prompts/image-prompts.md and series.config.json exist.

If any check fails, stop and report the missing image artifact. Do not generate a placeholder PDF.

Phase 4: PDF

Use the PDF creation path to assemble article.md plus image manifest into exports/final.pdf.

The PDF must contain:

• title page
• chapter text
• matching chapter image near each section
• closing summary

Use a PDF library such as reportlab when available. The file must be large enough to plausibly contain text and images; a tiny one-page placeholder PDF is a failure.

Do not use a Markdown-to-PDF command by itself unless the Markdown contains real image links and the generated PDF is verified to contain embedded image objects.

After creating the PDF, verify at least one embedded image object exists and the image count is at least the chapter count. With pypdf, use an equivalent check:

from pypdf import PdfReader

reader = PdfReader("exports/final.pdf")
image_count = 0
for page in reader.pages:
    resources = page.get("/Resources", {})
    xobjects = resources.get("/XObject", {})
    if hasattr(xobjects, "get_object"):
        xobjects = xobjects.get_object()
    for obj in xobjects.values():
        target = obj.get_object()
        if target.get("/Subtype") == "/Image":
            image_count += 1
assert image_count >= EXPECTED_CHAPTER_COUNT, image_count

Phase 5: Delivery Check

Before final response, run equivalent checks:

find . -maxdepth 4 -type f | sort
file exports/final.pdf
pdfinfo exports/final.pdf
pdftotext exports/final.pdf - | head -40

Also run an embedded-image check equivalent to the pypdf snippet in Phase 4.

Only report success if exports/final.pdf exists, the expected source files are present, and the PDF contains embedded images. If the PDF has no embedded image objects, report it as incomplete and keep the missing-image issue visible.