chart-generation

Generate accurate, data-driven charts and visualizations using Python (matplotlib/plotly).

Use this for real data. For concept art and illustrations, use image-generation instead.

What It Produces

| Chart Type | Use Case | Script | |------------|----------|--------| | Bar Chart | Compare values across categories | bar_chart.py | | Line Chart | Show trends over time | line_chart.py | | Pie Chart | Show proportions/percentages | pie_chart.py | | Positioning Matrix | 2x2 competitive positioning | positioning_matrix.py | | Comparison Table | Feature comparison grid | comparison_table.py | | TAM/SAM/SOM | Market size visualization | tam_sam_som.py |

Prerequisites

pip install matplotlib numpy pillow

No API keys required - runs locally.

When to Use This vs Image Generation

| Scenario | Use This | Use image-generation | |----------|----------|---------------------| | Real data from analysis | ✅ | ❌ | | Accurate numbers/labels | ✅ | ❌ | | Reproducible charts | ✅ | ❌ | | Concept/mockup visuals | ❌ | ✅ | | Artistic illustrations | ❌ | ✅ | | Icons and graphics | ❌ | ✅ |

---

Chart Types

1. Bar Chart

Compare values across categories.

python3 ${SKILL_PATH}/skills/chart-generation/scripts/bar_chart.py \
  --labels '["Product A", "Product B", "Product C"]' \
  --values '[85, 62, 45]' \
  --title "Feature Comparison" \
  --ylabel "Score" \
  --output bar_chart.png

Options:

• --horizontal - Horizontal bars instead of vertical
• --colors - Custom colors: '["#4CAF50", "#2196F3", "#FF9800"]'
• --show-values - Display values on bars

---

2. Line Chart

Show trends over time or progression.

python3 ${SKILL_PATH}/skills/chart-generation/scripts/line_chart.py \
  --x '["Jan", "Feb", "Mar", "Apr", "May", "Jun"]' \
  --y '[100, 150, 180, 220, 310, 450]' \
  --title "Monthly Revenue Growth" \
  --xlabel "Month" \
  --ylabel "Revenue ($K)" \
  --output growth_chart.png

Options:

• --multi - Multiple lines: --y '[[100,150,200], [80,120,180]]' --legend '["Product A", "Product B"]'
• --fill - Fill area under line
• --markers - Show data point markers

---

3. Pie Chart

Show proportions and percentages.

python3 ${SKILL_PATH}/skills/chart-generation/scripts/pie_chart.py \
  --labels '["Engineering", "Marketing", "Sales", "Operations"]' \
  --values '[40, 25, 20, 15]' \
  --title "Use of Funds" \
  --output pie_chart.png

Options:

• --donut - Donut chart (hollow center)
• --explode - Explode a slice: --explode 0 (first slice)
• --show-percent - Show percentages on slices

---

4. Positioning Matrix (2x2)

Competitive positioning on two axes.

python3 ${SKILL_PATH}/skills/chart-generation/scripts/positioning_matrix.py \
  --companies '["Your Product", "Competitor A", "Competitor B", "Competitor C"]' \
  --x-values '[70, 90, 50, 30]' \
  --y-values '[80, 85, 60, 45]' \
  --x-label "Price (Low → High)" \
  --y-label "Features (Basic → Advanced)" \
  --title "Competitive Positioning" \
  --output positioning.png

Options:

• --quadrant-labels - Label quadrants: '["Niche", "Leaders", "Laggards", "Challengers"]'
• --highlight - Highlight your position: --highlight 0
• --sizes - Bubble sizes for market share

---

5. Comparison Table

Feature comparison grid as an image.

python3 ${SKILL_PATH}/skills/chart-generation/scripts/comparison_table.py \
  --features '["Feature A", "Feature B", "Feature C", "Feature D"]' \
  --companies '["You", "Comp A", "Comp B"]' \
  --data '[["✓", "✓", "✗"], ["✓", "✗", "✓"], ["✓", "✓", "✓"], ["✓", "✗", "✗"]]' \
  --title "Feature Comparison" \
  --output comparison.png

Options:

• --highlight-column - Highlight your column: --highlight-column 0
• --colors - Use colors instead of symbols

---

6. TAM/SAM/SOM Chart

Market size visualization (concentric circles).

python3 ${SKILL_PATH}/skills/chart-generation/scripts/tam_sam_som.py \
  --tam 50 \
  --sam 8 \
  --som 0.5 \
  --unit "B" \
  --title "Market Opportunity" \
  --output market_size.png

Options:

• --unit - "B" for billions, "M" for millions
• --labels - Custom labels: '["Total Market", "Serviceable", "Obtainable"]'

---

Usage by Other Skills

competitive-intel-agent

# Generate positioning matrix from analysis
positioning_matrix.py \
  --companies '["You", "Salesforce", "HubSpot"]' \
  --x-values '[30, 95, 70]' \
  --y-values '[75, 90, 60]'

market-researcher-agent

# Generate TAM/SAM/SOM from research
tam_sam_som.py --tam 120 --sam 15 --som 2.5 --unit "B"

pitch-deck-agent

# Generate traction chart
line_chart.py \
  --x '["Q1", "Q2", "Q3", "Q4"]' \
  --y '[50, 120, 280, 500]' \
  --title "Revenue Growth"

review-analyst-agent

# Generate sentiment distribution
pie_chart.py \
  --labels '["Positive", "Neutral", "Negative"]' \
  --values '[65, 20, 15]' \
  --title "Review Sentiment"

---

Output Formats

All scripts support:

• --output file.png - PNG image (default)
• --output file.svg - SVG vector
• --output file.pdf - PDF document

---

Styling Options

All scripts support these common options:

| Option | Description | Example | |--------|-------------|---------| | --title | Chart title | "Monthly Revenue" | | --width | Width in inches | 12 | | --height | Height in inches | 8 | | --dpi | Resolution | 150 | | --style | Matplotlib style | "seaborn", "dark_background" | | --colors | Custom color palette | '["#4CAF50", "#2196F3"]' | | --font-size | Base font size | 12 |

---

Integration Pattern

Higher-level skills call chart-generation like this:

## In competitive-intel-agent workflow:

1. Analyze competitors (gather data)
2. Structure data as JSON
3. Call chart-generation script with data
4. Embed resulting PNG in report

Example flow:

# 1. Analysis produces this data
data = {
    "companies": ["You", "Competitor A", "Competitor B"],
    "features": [8, 6, 5],
    "prices": [29, 49, 39]
}

# 2. Generate chart
python3 bar_chart.py \
  --labels '["You", "Competitor A", "Competitor B"]' \
  --values '[8, 6, 5]' \
  --title "Feature Count Comparison" \
  --output features.png

# 3. Embed in report
![Feature Comparison](features.png)

---

Example Prompts

Direct chart creation:

"Create a bar chart comparing our features to competitors"

As part of analysis:

"Analyze these companies and generate a positioning matrix"

Data visualization:

"Plot our monthly revenue growth from this data: [100, 150, 220, 350]"

Market sizing:

"Create a TAM/SAM/SOM chart: TAM $50B, SAM $5B, SOM $500M"