Infographics

Overview

Infographics are visual representations of information, data, or knowledge designed to present complex content quickly and clearly. This skill uses Nano Banana 2 AI for infographic generation with Gemini 3.7 Flash quality review and Perplexity Sonar for research.

How it works:

• (Optional) Research phase: Gather candidate facts and source records using Perplexity Sonar Pro
• Describe your infographic in natural language
• Nano Banana 2 generates raster drafts from your content
• Gemini 3.7 Flash reviews quality against document-type thresholds
• Smart iteration: Regenerates when review requests improvements, within the iteration budget
• Inspect every final image at its intended display size and check claims against sources

Quality Thresholds by Document Type:

Simply describe what you want, and Nano Banana 2 creates it.

Quick Start

Install the only runtime dependency in your chosen Python environment (python -m pip install requests), then set OPENROUTER_API_KEY. Examples below illustrate CLI usage; paid generation was not executed during this review. Scripts accept PNG output paths only.

Generate a draft by describing it:

# Generate a list infographic (default threshold 7.5/10)
python skills/infographics/scripts/generate_infographic.py \
  "5 benefits of regular exercise" \
  -o figures/exercise_benefits.png --type list

# Generate for marketing (highest threshold: 8.5/10)
python skills/infographics/scripts/generate_infographic.py \
  "Product features comparison" \
  -o figures/product_comparison.png --type comparison --doc-type marketing

# Generate with corporate style
python skills/infographics/scripts/generate_infographic.py \
  "Company milestones 2010-2025" \
  -o figures/timeline.png --type timeline --style corporate

# Generate with colorblind-safe palette
python skills/infographics/scripts/generate_infographic.py \
  "Heart disease statistics worldwide" \
  -o figures/health_stats.png --type statistical --palette wong

# Generate WITH RESEARCH for accurate, up-to-date data
python skills/infographics/scripts/generate_infographic.py \
  "Global AI market size and growth projections" \
  -o figures/ai_market.png --type statistical --research

What happens behind the scenes:

1. (Optional) Research: Perplexity Sonar Pro gathers candidate facts with source annotations
2. Generation 1: Nano Banana 2 creates initial infographic following design best practices
3. Review 1: Gemini 3.7 Flash evaluates quality against document-type threshold
4. Decision: Stop when the scored review meets threshold and requests no further changes
5. If improvements are requested: Retain content and source context, refine the prompt, regenerate
6. Repeat: Until quality meets threshold or the iteration budget is reached; stop on API failure and keep the latest saved draft

Smart Iteration Benefits:

• ✅ Saves API calls if first generation is good enough
• ✅ Higher quality standards for marketing materials
• ✅ Faster turnaround for drafts/internal use
• ✅ Appropriate quality for each use case

Output: Versioned PNGs plus a review log with models, scores, quality_met, and termination_reason. A saved image (success: true) can still be unreviewed or below threshold. Human factual and visual checks remain required.

When to Use This Skill

Use the infographics skill when:

• Presenting data or statistics in a visual format
• Creating timeline visualizations for project milestones or history
• Explaining processes, workflows, or step-by-step guides
• Comparing options, products, or concepts side-by-side
• Summarizing key points in an engaging visual format
• Creating geographic or map-based data visualizations
• Building hierarchical or organizational charts
• Designing social media content or marketing materials

Use scientific-schematics instead for:

• Technical flowcharts and circuit diagrams
• Biological pathways and molecular diagrams
• Neural network architecture diagrams
• CONSORT/PRISMA methodology diagrams

Research Integration

Automatic Data Gathering (--research)

When creating infographics that require accurate, up-to-date data, use the --research flag to gather candidate facts and statistics using Perplexity Sonar Pro. The script preserves source annotations; it does not independently verify claims or source relevance. For scientific or medical publication, verify primary sources before including the resulting numbers.

# Research and generate statistical infographic
python skills/infographics/scripts/generate_infographic.py \
  "Global renewable energy adoption rates by country" \
  -o figures/renewable_energy.png --type statistical --research

# Research for timeline infographic
python skills/infographics/scripts/generate_infographic.py \
  "History of artificial intelligence breakthroughs" \
  -o figures/ai_history.png --type timeline --research

# Research for comparison infographic
python skills/infographics/scripts/generate_infographic.py \
  "Electric vehicles vs hydrogen vehicles comparison" \
  -o figures/ev_hydrogen.png --type comparison --research

What Research Provides

The research phase automatically:

1. Gathers Key Facts: 5-8 relevant facts and statistics about the topic
2. Provides Context: Background information for accurate representation
3. Requests Data Points: Numbers with units, populations, denominators, and dates
4. Preserves Sources: OpenRouter URL-citation annotations, plus optional provider citation fields
5. Dates the Request: Uses the current date while preserving historical event dates

When to Use Research

**Enable research (--research) for:**

• Statistical infographics requiring accurate numbers
• Market data, industry statistics, or trends
• Scientific or medical information
• Current events or recent developments
• Any topic where accuracy is critical

Skip research for:

• Simple conceptual infographics
• Internal process documentation
• Topics where you provide all the data in the prompt
• Speed-critical generation

Research Output

When research is enabled, additional files are created:

• {name}_research.json - Research answer and returned source records (when research succeeds)
• Research content and source records remain in generation, review, and refinement prompts
• Failed research is recorded in the review log; generation continues with the supplied prompt

Infographic Types

Ten types are supported via --type: statistical, timeline, process, comparison, list, geographic, hierarchical, anatomical, resume, and social. What each is for, the data shape it expects, and worked prompts are in references/infographic_type_catalog.md and references/infographic_types.md.

Style Presets

Industry Styles (--style)

# Corporate style
python skills/infographics/scripts/generate_infographic.py \
  "Q4 Results" -o q4.png --type statistical --style corporate

# Healthcare style
python skills/infographics/scripts/generate_infographic.py \
  "Patient Journey" -o journey.png --type process --style healthcare

Colorblind-Safe Palettes

Available Palettes (--palette)

# Wong's colorblind-safe palette
python skills/infographics/scripts/generate_infographic.py \
  "Survey results by category" -o survey.png --type statistical --palette wong

Smart Iterative Refinement and CLI

The generate-review-refine loop, every command-line option, and configuration are in references/iterative_refinement.md.

Prompt Engineering Tips

Be Specific About Content

✓ Good prompts (specific, detailed):

"5 benefits of meditation: reduces stress, improves focus, 
better sleep, lower blood pressure, emotional balance"

✗ Avoid vague prompts:

"meditation infographic"

Include Data Points

✓ Good:

"Synthetic example: market grows from USD 10B (2020) to USD 45B (2025), CAGR 35.1%; label illustrative"

✗ Vague:

"market is growing"

Specify Visual Elements

✓ Good:

"Timeline showing 5 milestones with icons for each event"

API and model contract

Reviewed against OpenRouter documentation and its public model catalogs on 2026-10-01:

• Generation: google/gemini-3.1-flash-image (Nano Banana 2), POST /api/v1/images, prompt, n: 1, optional input_references; reads data[0].b64_json and validates media_type/PNG signature. Gemini endpoints do not advertise output_format, so the script checks the returned format rather than sending that option.
• Review: google/gemini-3.7-flash, POST /api/v1/chat/completions, text followed by an image_url data URL; reads choices[0].message.content.
• Research and the Python web_search() helper: perplexity/sonar-pro, same chat endpoint; uses web_search_options.search_context_size and preserves message.annotations[].url_citation. No separate search API or academic-mode guarantee is implied.
• All paid calls use bearer authentication with OPENROUTER_API_KEY; no automatic retries or pagination. Public discovery uses GET /api/v1/models, GET /api/v1/images/models, and each image model's /endpoints records.

See the Image API guide, image input contract, web-search options and citations, and authentication guide. Offline tests cover these payloads and failure paths; catalog availability is not proof of an authenticated generation or of factual accuracy. Use code-based plotting or GIS when exact numerical geometry, reproducibility, or map boundaries are essential.

Reference Files

For detailed guidance, load these reference files:

• **references/infographic_types.md**: Extended templates for all 10+ types
• **references/design_principles.md**: Visual hierarchy, layout, typography
• **references/color_palettes.md**: Full palette specifications

Troubleshooting

Common Issues

Problem: Text in infographic is unreadable

• Solution: Reduce text content; use --type to specify layout type

Problem: Colors clash or are inaccessible

• Solution: Use --palette wong for colorblind-safe colors

Problem: Quality score too low

• Solution: Inspect the critique and retained draft; improve the prompt, then explicitly choose an iteration budget with --iterations N (default 3)

Problem: Wrong infographic type generated

• Solution: Always specify --type flag for consistent results

Integration with Other Skills

This skill works synergistically with:

• scientific-schematics: For technical diagrams and flowcharts
• market-research-reports: Infographics for business reports
• scientific-slides: Infographic elements for presentations
• generate-image: For non-infographic visual content

Quick Reference Checklist

Before generating:

• [ ] Clear, specific content description
• [ ] Infographic type selected (--type)
• [ ] Style appropriate for audience (--style)
• [ ] Output path specified (-o)
• [ ] API key configured

After generating:

• [ ] Review the generated image
• [ ] Check the review log for scores
• [ ] Compare every number, unit, label, and source in the image against the verified input; an AI quality score is not a factual check
• [ ] Supply a short alt description plus a readable data table or long description covering the key values and relationships, following W3C guidance for complex images
• [ ] Regenerate with more specific prompt if needed

Use this skill to create professional, accessible, and visually compelling infographics using the power of Nano Banana 2 AI with intelligent quality review.