SurgePixSurgePix
Home>Skills Library>Illustration Creator

Illustration Creator

Generate AI-powered 16:9 hand-drawn article illustrations (1536×864) for blogs, WeChat Official Account posts, and tweets — optimized for autonomous agent skill calling and automated workflows. Use when the user asks for article illustrations, blog images, WeChat OA graphics, tweet visuals, or horizontal editorial art. Accepts natural language prompts, per-shot specs, or style reference images. Returns a download URL, session ID, and task ID, with async execution and automatic polling. Supports multi-image packs (ZIP), session-based multi-turn iteration, and auto language detection for on-image labels.

npx skills add https://github.com/surgepix/agent-skills --skill surgepix-generate-illustrations
Download ZIPGitHub

SurgePix Generate Illustrations

Generate 16:9 horizontal article illustrations (hand-drawn style, fixed 1536×864) from a topic or per-shot specifications, and get a download URL.

What the Skill Does

ActionDescription
Generate illustrationsCreate 16:9 horizontal illustrations from topic or per-shot specs
Upload reference imageUpload a style reference image to calibrate the illustration style
Check task statusPoll a generation task by taskId to check progress manuually
Download resultRetrieve the .pptx download URL directly from the task result
  • --nowait false (default) — the script polls internally until the task is succeeded / failed and returns the final URL in one call.
  • --nowait true — the script returns the taskId immediately without waiting; resolve it later with the surgepix-query-task skill.

Workflow

  1. Step 0: Check environment (required)

    Before running, verify config:

    node "<skills-dir>/surgepix-setup/scripts/check_env.mjs"
    • Exit 0 → proceed to Step 1
    • Exit 1 → follow surgepix-setup skill to configure .env, then retry
  2. Step 1: Gather inputs

    At least one of --topic or --shots/--shots-file must be provided.

    • Topic (conditionally required): article topic or body text summary. Required when --shots is not provided.
    • Shots (optional): per-shot illustration specifications as a JSON array (inline via --shots or from file via --shots-file ). When provided, takes priority over --topic/--count and generates images in array order.
    • Count (optional, default 4, range 1-9): number of images to auto-generate from --topic . Only effective when--shots is not provided.
    • Reference image (optional): local file path or image URL for style calibration; script uploads automatically. Repeatable for multiple images. Supported formats: JPEG, JPG, PNG, WEBP — max 20MB each.
    • Session ID (optional): if the user is iterating on a previous result, ask them to provide the sessionId (number type) printed by the last run.

    Shot Specification Object (for --shots array elements):

    FieldRequiredDescription
    themeYesThis image's theme
    structureTypeNoStructure type, e.g. Workflow / before-after / concept metaphor
    coreIdeaNoCore message this image should convey
    compositionNoSpecific scene description
    elementsNoSuggested visual elements (string array)
    labelsNoSuggested handwritten annotation labels (string array; use the user's language)
  3. Step 2: Run generate-illustrations

    node "<skills-dir>/surgepix-generate-illustrations/scripts/generate_illustrations.mjs" \
      [--topic "<text>"] [--shots '<json>'] [--shots-file "<path>"] \
      [--count <1-9>] [--reference "<path-or-url>" ...] \
      [--session-id <id>] [--nowait <true|false>]
    FlagDescription
    --topic <text>Article topic or body summary (required when shots not provided)
    --shots <json>Per-shot specs as inline JSON array
    --shots-file <path>Per-shot specs from a JSON file
    --count <1-9>Auto-generate count from topic, default 4
    --reference <path-or-url>Style reference image (local path auto-uploaded; repeatable)
    --session-id <id>Session ID; pass the sessionId (number type) from a previous run to iterate
    --nowait <true|false>Wait mode, default false false (see below)

    The request is always submitted asynchronously. --nowait false (default) makes the script poll internally until the task completes and returns the final download--nowait true makes the script return the taskId immediately, to be resolved later via the surgepix-query-task skill.

  4. Step 3: Parse output

    Sync success (--nowait false, stdout):

    {"ok":true,"taskId":"task_xxx","sessionId":123,"progress":"succeeded","download":"https://...illustrations.zip","imageCount":4,"resultType":"zip","note":"API 仅返回 ZIP 下载地址,不含单张图片 URL;禁止编造单张链接"}

    Async submitted (--nowait true, stdout) — resolve later with the surgepix-query-task skill:

    {"ok":true,"async":true,"taskId":"task_xxx","sessionId":123,"progress":"processing","download":null,"hint":"..."}

    Failure (stderr):

    {"ok":false,"error":"..."}
  5. Step 4: Present result

    • On success: Show only the download URL from script output. Always show sessionId (note: it is a number type, e.g. 123) so the user can pass it in a retry if needed
      • resultType: "image" (imageCount === 1): download is a single image URL
      • resultType: "zip" (imageCount > 1): download is a ZIP file — do not list per-image URLs
    • On failure: Report the error field. Common causes:
      • Missing required parameter — neither --topic nor --shots / --shots-file provided
      • --count out of range (must be 1–9)
      • --shots JSON parse error
      • Reference image format not supported or exceeds 20MB
      • Generation failed — internal error; retry or simplify the topic
    • The result is automatically attached to the session (auto-created or reused). The user can open the platform frontend to see all iterations in one place.
    • If the user is not satisfied and wants to iterate, instruct them to pass --session-id <sessionId> (number type) in the next run — both versions appear in the same session history on the frontend.

More skills from SurgePix

Presentation Creator

Generate AI-powered presentations from a prompt, outline, or document.

Poster Creator

Generate AI-powered event posters from structured event details and creative direction.

XHS Creator

Generate Xiaohongshu vertical carousel image sets from per-page copy descriptions.

Brand Logo Generator

Generate a brand logo image from a text description plus optional reference images.

Film Storyboards Generator

Generate film storyboard images from a script / storyboard description.

Photo to Minimalist Art

Generate photo-poetic editorial artwork from uploaded images.

AI Surreal Art Generator

Reimagine everyday photos as surreal cinematic artwork with bold color fields, unexpected scale, and dramatic light.

Generate Brand Placement

Generate images while locking a brand logo and/or fixed text to a consistent position.

Generate Channel Crop Pack

Generate a channel crop pack from one or more source images.

Background Remover

Generate AI-powered transparent PNGs by removing image backgrounds.

Image Translator

Translate text on one or more images to a target language while preserving the background.

PPT Translator

Translate all text content in a PowerPoint (.pptx) file into a target language.

Image Editing / Style Change

Edit an image via reference images and a text edit instruction.

SurgePixSurgePix

Create & Edit Visuals with AI

Contact UsXDiscordEmail[email protected]
ToolsPDF to JPG converterPNG to JPG converterJPG to PDF converterHEIC to PDF converterHEIC to PNG converterImage ResizerAI Image EditorYouTube Banner MakerAI HairstyleFather's day 2026Mother's day 2026Bar Graph MakerPie Chart MakerVenn Diagram Maker
Helpful ResourcesTate-A-TateSurgeflowSkills LibraryPresentation CreatorPoster CreatorIllustration CreatorXHS CreatorBackground RemoverImage TranslatorPPT TranslatorBrand Logo GeneratorFilm Storyboards GeneratorPhoto to Minimalist ArtAI Surreal Art GeneratorGenerate Brand PlacementGenerate Channel Crop PackImage Editing / Style Change

© 2026 SurgePix. All rights reserved. Made with ❤️ for productivity.