Infographic

Infographic Generation (infographic)

Reference Images (Important)

If you use reference images (image-to-image / series reference / consistency refs):

• Reference images must be public URLs.
• HTTPS is strongly recommended.
• http:// may work but is insecure and can be blocked by some networks.
• Local file paths and data: URLs are not supported by the WeryAI gateway.

This skill turns complex source material into a single high-density infographic.

Maintain the layout and style mapping when the bundled generation runtime updates, and re-check recent runtime behavior if a newer version changes prompt handling.

Script:

• scripts/scaffold.ts
• scripts/build-prompt.ts
• scripts/build-batch.ts

Safety & Scope

• Network: This skill calls the WeryAI gateway over HTTPS (https://api.weryai.com).
• Auth: Uses IMAGE_GEN_API_KEY. The key is never printed. It may be persisted only when you explicitly run npm run setup -- --persist-api-key.
• Reference images: Must be public URLs (https:// recommended). http:// may work but is insecure. Local file paths and data: URLs are rejected.
• No arbitrary shell: The generation runtime does not execute arbitrary shell commands.
• Files written: Output images and optional local config under .image-skills/infographic/ (project) and/or ~/.image-skills/infographic/ (home).

Use Cases

• high-density information graphics
• visual summaries
• data relationship graphics
• process posters
• content that needs to be explained in one image

Not a good fit for:

• a single article cover image
• multi-card RedNote content
• a sequential comic narrative

Core Dimensions

1. layout: the information structure
2. style: the visual language

See:

• references/analysis-framework.md
• references/structured-content-template.md
• references/layouts-and-styles.md
• references/prompt-template.md

Commands

Workflow

Step 1: Initialize Working Files

Create the working directory and starter files:

${BUN_X} {baseDir}/scripts/scaffold.ts \
  --output-dir infographic/topic-slug \
  --topic "Topic name" \
  --lang en

This creates:

• analysis.md
• structured-content.md
• prompts/infographic.md

Step 2: Understand the Source

Extract:

• the main topic
• the target audience
• the density of information
• whether the content is driven by data, lists, hierarchy, process, or comparison
• the user's language, especially for titles, labels, and annotations

Save the result to analysis.md, using:

• references/analysis-framework.md

Step 3: Organize Structured Content

Before selecting the final layout and style, rewrite the material into structured-content.md:

• references/structured-content-template.md

This step should make titles, sections, labels, and data points explicit.

Step 4: Choose layout and style

Default priorities:

• layout: bento-grid
• style: infographic

Recommended rules:

• step-by-step tutorial -> linear-progression
• comparison -> binary-comparison
• hierarchy -> hierarchical-layers
• broad knowledge overview -> bento-grid
• dense modular content -> dense-modules

If the user explicitly asks for a specific visual direction, follow that preference.

Step 5: Build batch.json for Variants

If you want to explore multiple infographic directions, place multiple prompt files in prompts/, for example:

• 01-technical.md
• 02-minimal.md
• 03-bold.md

Then generate a batch file:

${BUN_X} {baseDir}/scripts/build-batch.ts \
  --prompts infographic/topic-slug/prompts \
  --output infographic/topic-slug/batch.json \
  --images-dir infographic/topic-slug \
  --model "$M" \
  --jobs 3

The script reads Style direction: and Aspect ratio: from each prompt file when possible, then maps them into generation task fields.

Step 6: Build the Final Prompt

Convert structured-content.md into the final prompt:

${BUN_X} {baseDir}/scripts/build-prompt.ts \
  --structured-content infographic/topic-slug/structured-content.md \
  --output infographic/topic-slug/prompts/infographic.md \
  --audience "product teams" \
  --style technical-schematic \
  --aspect 4:3 \
  --lang en

This keeps the prompt synchronized with the structured content instead of rewriting it by hand.

Step 7: Map to the Bundled Runtime

The bundled image runtime currently exposes one structured style argument, --style, so:

• map style to --style
• write layout, labels, hierarchy, and information relationships into the prompt body
• prefer 3:4, 4:3, or 16:9 depending on content shape

Recommended mapping:

Use references/prompt-template.md and make sure to:

• define the main title, subtitle, sections, and labels explicitly
• include numbers, years, and terminology directly when possible
• emphasize hierarchy, whitespace, and readability instead of abstract style-only wording
• state the target language explicitly if the image needs on-canvas text

Step 8: Run Generation

On first use in a new project, run npm run ensure-ready -- --project <your-project> --workflow infographic from this skill directory before generation. This reads the doctor report and auto-runs bootstrap if local script dependencies are still missing. If the report shows a missing IMAGE_GEN_API_KEY and the user approves, run npm run setup -- --project <your-project> --workflow infographic --persist-api-key when the key is already in env, or persist it to .image-skills/infographic/.env on the user's behalf, then continue without leaving this workflow.

When this skill is first connected, tell the user that the default generation model is Nano Banana 2 (GEMINI_3_1_FLASH_IMAGE). Also tell them it can be switched later whenever another model fits the task better.

${BUN_X} {baseDir}/npm run generate \
  --promptfiles prompts/infographic.md \
  --style infographic \
  --image infographic/topic-slug/infographic.png \
  --ar 3:4 \
  -m "$M"

Batch example:

${BUN_X} {baseDir}/npm run generate \
  --batchfile infographic/topic-slug/batch.json \
  --jobs 3

If the user has not chosen a model yet, follow this skill's model-selection rules first.

Output Convention

Suggested output directory:

infographic/<topic-slug>/

Suggested minimum files:

• analysis.md
• structured-content.md
• prompts/infographic.md
• batch.json
• infographic.png

Re-run Behavior

• scaffold.ts on an existing directory overwrites analysis.md, structured-content.md, and the starter prompt files.
• build-prompt.ts overwrites the target prompt file each time it runs.
• build-batch.ts overwrites batch.json.
• Re-running the base generator with the same --image path overwrites the existing infographic output.
• If multiple prompt variants are listed in batch.json, re-running the batch regenerates all listed variants unless you remove the ones you want to keep.

Definition of Done

• analysis.md, structured-content.md, and prompts/infographic.md exist in the output directory.
• The generated infographic matches the chosen layout / style / aspect.
• The image is shown directly to the user with a summary of the parameters used.
• A compressed webp version is produced for delivery.

Iteration

When the user wants changes after seeing the generated infographic:

• Layout issues ("too crowded", "unclear hierarchy") → switch layout in structured-content.md and rebuild the prompt. Try a different layout pattern.
• Style mismatch ("too busy", "not professional enough") → change style / --style, re-generate.
• Content issues ("missing X", "remove this section") → revise structured-content.md, rebuild prompt with build-prompt.ts, re-generate.
• Text readability ("text too small", "can't read it") → reduce information density in the prompt, or switch to a less text-heavy layout.
• Want to explore alternatives → create multiple prompt variants in prompts/, batch-generate to compare layouts and styles.

Infographics are single-image outputs, so each iteration only re-generates one image.

Delivery

When the infographic is ready:

1. Show the image directly — do not just print a file path.
2. Briefly state: layout type, style, aspect ratio.
3. Ask if the user wants changes (layout, content, style) or is satisfied.
4. Auto-compress: once confirmed, run the canonical compression runtime to produce a webp version.

${BUN_X} {baseDir}/../compression-runtime/scripts/main.ts infographic/topic-slug/infographic.png -f webp -q 85

If multiple variants were generated via batch, show all of them and let the user pick the best one.

Internal checklist (for agent): layout / style / aspect, information division, model, text language, compression done.