name: charts
description: Generate charts and graphs from data for reports. Use when user wants to visualize data, create charts, graphs, plots, or diagrams from CSV, JSON, or query results.
allowed-tools:
- Read
- Bash(~/.claude/skills/charts/:)

Charts Skill

Generate charts and graphs from data using matplotlib.

Commands

Data Input Methods

1. Inline data

charts bar --labels "A,B,C" --values "10,20,30"

2. From CSV/JSON file

charts line --file data.csv --x date --y revenue

3. From stdin (pipe)

echo "name,value
Product A,100
Product B,150" | charts bar --x name --y value

4. Combined with database skill

database query "SELECT status, COUNT(*) as count FROM orders GROUP BY status" | charts pie --x status --y count --title "Order Status"

Common Options

• --title "Text" - Set chart title
• --output file.png - Specify output path (default: /tmp/chart__.png)
• --open - Open image after generating
• --x column - Column for X axis / labels
• --y column - Column for Y axis / values

Chart-Specific Options

Bar chart

• --horizontal - Horizontal bars instead of vertical

Histogram

• --column name - Column to analyze
• --bins N - Number of bins (default: 10)

Output

By default, charts are saved to /tmp/chart_<type>_<timestamp>.png and the path is printed to stdout.

Use the Read tool to view the generated chart image.

Examples

# Sales by month
charts bar --labels "Jan,Feb,Mar,Apr" --values "12000,15000,13500,18000" --title "Monthly Sales"

# Revenue trend from CSV
charts line --file sales.csv --x month --y revenue --title "Revenue Trend"

# Distribution pie chart
charts pie --labels "Desktop,Mobile,Tablet" --values "55,35,10" --title "Traffic by Device"

# Query results visualization
database query "SELECT date, amount FROM transactions ORDER BY date" | charts line --x date --y amount --title "Transaction History"

# Age distribution histogram
charts histogram --file users.csv --column age --bins 15 --title "User Age Distribution"