Infographics

Infographics

Overview

Infographics are visual representations of information, data, or knowledge designed to present complex content quickly and clearly. This skill uses configured research, image-generation, and quality-review providers for infographic generation and review.

How it works:

• (Optional) Research phase: Gather accurate facts and statistics using the configured research provider
• Describe your infographic in natural language
• the configured image-generation provider generates publication-quality infographics automatically
• the configured review provider reviews quality against document-type thresholds
• Smart iteration: Only regenerates if quality is below threshold
• Professional-ready output in minutes
• No design skills required

Quality Thresholds by Document Type:

Simply describe what you want, and the configured image-generation provider creates it.

Quick Start

Generate any infographic by simply 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: the configured research provider gathers accurate facts, statistics, and data
2. Generation 1: the configured image-generation provider creates initial infographic following design best practices
3. Review 1: the configured review provider evaluates quality against document-type threshold
4. Decision: If quality >= threshold → DONE (no more iterations needed!)
5. If below threshold: Improved prompt based on critique, regenerate
6. Repeat: Until quality meets threshold OR max iterations reached

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 images plus a detailed review log with quality scores, critiques, and early-stop information.

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 automatically gather facts and statistics using the configured research provider Pro.

# 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. Finds Data Points: Specific numbers, percentages, and dates
4. Cites Sources: Mentions major studies or sources
5. Prioritizes Recency: Focuses on 2023-2026 information

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 - Raw research data and sources
• Research content is automatically incorporated into the infographic prompt

Infographic Types

1. Statistical/Data-Driven (--type statistical)

Best for: Presenting numbers, percentages, survey results, and quantitative data.

Key Elements: Charts (bar, pie, line, donut), large numerical callouts, data comparisons, trend indicators.

python skills/infographics/scripts/generate_infographic.py \
  "Global internet usage 2025: 5.5 billion users (68% of population), \
   Asia Pacific 53%, Europe 15%, Americas 20%, Africa 12%" \
  -o figures/internet_stats.png --type statistical --style technology

2. Timeline (--type timeline)

Best for: Historical events, project milestones, company history, evolution of concepts.

Key Elements: Chronological flow, date markers, event nodes, connecting lines.

python skills/infographics/scripts/generate_infographic.py \
  "History of AI: 1950 Turing Test, 1956 Dartmouth Conference, \
   1997 Deep Blue, 2016 AlphaGo, 2022 ChatGPT" \
  -o figures/ai_history.png --type timeline --style technology

3. Process/How-To (--type process)

Best for: Step-by-step instructions, workflows, procedures, tutorials.

Key Elements: Numbered steps, directional arrows, action icons, clear flow.

python skills/infographics/scripts/generate_infographic.py \
  "How to start a podcast: 1. Choose your niche, 2. Plan content, \
   3. Set up equipment, 4. Record episodes, 5. Publish and promote" \
  -o figures/podcast_process.png --type process --style marketing

4. Comparison (--type comparison)

Best for: Product comparisons, pros/cons, before/after, option evaluation.

Key Elements: Side-by-side layout, matching categories, check/cross indicators.

python skills/infographics/scripts/generate_infographic.py \
  "Electric vs Gas Cars: Fuel cost (lower vs higher), \
   Maintenance (less vs more), Range (improving vs established)" \
  -o figures/ev_comparison.png --type comparison --style nature

5. List/Informational (--type list)

Best for: Tips, facts, key points, summaries, quick reference guides.

Key Elements: Numbered or bulleted points, icons, clear hierarchy.

python skills/infographics/scripts/generate_infographic.py \
  "7 Habits of Highly Effective People: Be Proactive, \
   Begin with End in Mind, Put First Things First, Think Win-Win, \
   Seek First to Understand, Synergize, Sharpen the Saw" \
  -o figures/habits.png --type list --style corporate

6. Geographic (--type geographic)

Best for: Regional data, demographics, location-based statistics, global trends.

Key Elements: Map visualization, color coding, data overlays, legend.

python skills/infographics/scripts/generate_infographic.py \
  "Renewable energy adoption by region: Iceland 100%, Norway 98%, \
   Germany 50%, USA 22%, India 20%" \
  -o figures/renewable_map.png --type geographic --style nature

7. Hierarchical/Pyramid (--type hierarchical)

Best for: Organizational structures, priority levels, importance ranking.

Key Elements: Pyramid or tree structure, distinct levels, size progression.

python skills/infographics/scripts/generate_infographic.py \
  "Maslow's Hierarchy: Physiological, Safety, Love/Belonging, \
   Esteem, Self-Actualization" \
  -o figures/maslow.png --type hierarchical --style education

8. Anatomical/Visual Metaphor (--type anatomical)

Best for: Explaining complex systems using familiar visual metaphors.

Key Elements: Central metaphor image, labeled parts, connection lines.

python skills/infographics/scripts/generate_infographic.py \
  "Business as a human body: Brain=Leadership, Heart=Culture, \
   Arms=Sales, Legs=Operations, Skeleton=Systems" \
  -o figures/business_body.png --type anatomical --style corporate

9. Resume/Professional (--type resume)

Best for: Personal branding, CVs, portfolio highlights, professional achievements.

Key Elements: Photo area, skills visualization, timeline, contact info.

python skills/infographics/scripts/generate_infographic.py \
  "UX Designer resume: Skills - User Research 95%, Wireframing 90%, \
   Prototyping 85%. Experience - 2020-2022 Junior, 2022-2025 Senior" \
  -o figures/resume.png --type resume --style technology

10. Social Media (--type social)

Best for: Instagram, LinkedIn, Twitter/X posts, shareable graphics.

Key Elements: Bold headline, minimal text, maximum impact, vibrant colors.

python skills/infographics/scripts/generate_infographic.py \
  "Save Water, Save Life: 2.2 billion people lack safe drinking water. \
   Tips: shorter showers, fix leaks, full loads only" \
  -o figures/water_social.png --type social --style marketing

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

How It Works

┌─────────────────────────────────────────────────────┐
│  1. Generate infographic with the configured image-generation provider       │
│                    ↓                                │
│  2. Review quality with the configured review provider                │
│                    ↓                                │
│  3. Score >= threshold?                             │
│       YES → DONE! (early stop)                      │
│       NO  → Improve prompt, go to step 1            │
│                    ↓                                │
│  4. Repeat until quality met OR max iterations      │
└─────────────────────────────────────────────────────┘

Quality Review Criteria

the configured review provider evaluates each infographic on:

1. Visual Hierarchy & Layout (0-2 points)

   • Clear visual hierarchy
   • Logical reading flow
   • Balanced composition

2. Typography & Readability (0-2 points)

   • Readable text
   • Bold headlines
   • No overlapping

3. Data Visualization (0-2 points)

   • Prominent numbers
   • Clear charts/icons
   • Proper labels

4. Color & Accessibility (0-2 points)

   • Professional colors
   • Sufficient contrast
   • Colorblind-friendly

5. Overall Impact (0-2 points)

   • Professional appearance
   • Free of visual bugs
   • Achieves communication goal

Review Log

Each generation produces a JSON review log:

{
  "user_prompt": "5 benefits of exercise...",
  "infographic_type": "list",
  "style": "healthcare",
  "doc_type": "marketing",
  "quality_threshold": 8.5,
  "iterations": [
    {
      "iteration": 1,
      "image_path": "figures/exercise_v1.png",
      "score": 8.7,
      "needs_improvement": false,
      "critique": "SCORE: 8.7\nSTRENGTHS:..."
    }
  ],
  "final_score": 8.7,
  "early_stop": true,
  "early_stop_reason": "Quality score 8.7 meets threshold 8.5"
}

Command-Line Reference

python skills/infographics/scripts/generate_infographic.py [OPTIONS] PROMPT

Arguments:
  PROMPT                    Description of the infographic content

Options:
  -o, --output PATH         Output file path (required)
  -t, --type TYPE           Infographic type preset
  -s, --style STYLE         Industry style preset
  -p, --palette PALETTE     Colorblind-safe palette
  -b, --background COLOR    Background color (default: white)
  --doc-type TYPE           Document type for quality threshold
  --iterations N            Maximum refinement iterations (default: 3)
  --api-key KEY             OpenRouter API key
  -v, --verbose             Verbose output
  --list-options            List all available options

List All Options

python skills/infographics/scripts/generate_infographic.py --list-options

Configuration

API Key Setup

Set your OpenRouter API key:

export OPENROUTER_API_KEY='your_api_key_here'

Get an API key at: https://openrouter.ai/keys

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:

"Market growth from $10B (2020) to $45B (2025), CAGR 35%"

✗ Vague:

"market is growing"

Specify Visual Elements

✓ Good:

"Timeline showing 5 milestones with icons for each event"

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: Increase iterations with --iterations 3; use more specific prompt

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
• Regenerate with more specific prompt if needed

Use this skill to create professional, accessible, and visually compelling infographics using the power of the configured image-generation provider with intelligent quality review.