chart-generator

# Chart Generator ## Freshness Last updated: `2026-06-24`. If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples. ## What This Tool Does Generate modern, professional charts and graphs from data. Supports multiple chart types including bar, line, pie, scatter, doughnut, radar, and more. Features five preset themes for different use cases: Corporate (professional blues and grays), Modern Dark (presentation-ready with vibrant accents), Minimal (publication-quality with subtle colors), Colorful (marketing-friendly with distinct hues), and Academic (colorblind-accessible). Charts can be exported in multiple formats including PNG, SVG, PDF, and WebP. The tool handles custom styling, responsive sizing, gradient fills, data labels, and complex configurations. Perfect for creating data visualizations for reports, presentations, dashboards, social media, and documentation. Returns chart images as signed URLs with configurable expiration or as base64-encoded data for immediate embedding. ## Product Instructions ### Chart Generator - Tool Instructions #### Overview Generate modern, professional charts and graphs from data. Supports 9 chart types (bar, line, pie, doughnut, scatter, bubble, radar, polar area, horizontal bar), 5 preset themes plus custom styling, and 4 export formats (PNG, SVG, PDF, WebP). Charts can be returned as cloud-stored file URLs or base64-encoded data for immediate embedding. Powered by QuickChart API (Chart.js compatible). --- #### Actions ##### generate_chart Generate a chart image from structured data with theme and format options. **Required Parameters:** - `chart_type` (string): Type of chart. One of: `"bar"`, `"line"`, `"pie"`, `"doughnut"`, `"scatter"`, `"bubble"`, `"radar"`, `"polarArea"`, `"horizontalBar"` - `data` (object): Chart.js compatible data object. Must contain `labels` (array of strings) and/or `datasets` (array of dataset objects). Each dataset has `label` (string), `data` (array of numbers or point objects), and optional color overrides (`backgroundColor`, `borderColor`, `borderWidth`). **Optional Parameters:** - `theme` (string, default: `"corporate"`): Preset theme. One of: - `"corporate"` - Professional blues/grays, white background, top legend. Best for business reports. - `"modern_dark"` - Dark background (#1E1E1E) with vibrant accent colors, bottom legend. Best for presentations. - `"minimal"` - Black/white/gray tones, very subtle grid. Best for publications. - `"colorful"` - Vibrant pink/blue/yellow/teal/purple/orange. Best for marketing and social media. - `"academic"` - Colorblind-accessible palette (blue, orange, green, purple, brown, gray), black grid. Best for scientific publications. - `"custom"` - No preset applied; use `custom_options` to style from scratch. - `width` (integer, default: 600, range: 100-2000): Chart width in pixels. - `height` (integer, default: 400, range: 100-2000): Chart height in pixels. - `title` (string): Chart title text displayed on the chart. - `background_color` (string, default: `"white"`): Background color. Accepts named colors (`"white"`, `"transparent"`), HEX (`"#FFFFFF"`), RGB (`"rgb(255,255,255)"`), or HSL. - `output_format` (string, default: `"png"`): Output format. One of: `"png"` (raster), `"svg"` (vector, scalable), `"pdf"` (document), `"webp"` (compressed). - `device_pixel_ratio` (integer, default: 1): `1` for normal displays, `2` for retina/high-DPI displays. - `custom_options` (object): Custom Chart.js options object to override theme defaults. Supports any Chart.js 3.x/4.x option (plugins, scales, etc.). - `return_base64` (boolean, default: false): If true, returns base64-encoded image data instead of a file URL. Useful for embedding in emails or immediate display. - `store_file` (boolean, default: true): If true, stores the chart in cloud storage and returns a signed download URL. - `expiration_days` (integer, default: 7, range: 1-7): Number of days until the stored file expires and is automatically deleted. **Example - Simple Bar Chart:** ```json { "action": "generate_chart", "chart_type": "bar", "data": { "labels": ["Q1", "Q2", "Q3", "Q4"], "datasets": [{"label": "Revenue", "data": [45000, 52000, 48000, 61000]}] }, "title": "Quarterly Revenue 2025", "theme": "corporate", "width": 800, "height": 500 } ``` **Example - Multi-Dataset Line Chart (Dark Theme, Retina):** ```json { "action": "generate_chart", "chart_type": "line", "data": { "labels": ["Jan", "Feb", "Mar", "Apr", "May", "Jun"], "datasets": [ {"label": "Product A", "data": [12, 19, 15, 22, 28, 25]}, {"label": "Product B", "data": [8, 14, 18, 16, 20, 24]} ] }, "title": "Product Sales Comparison", "theme": "modern_dark", "width": 1000, "height": 600, "output_format": "png", "device_pixel_ratio": 2 } ``` **Example - Pie Chart (Colorful):** ```json { "action": "generate_chart", "chart_type": "pie", "data": { "labels": ["Desktop", "Mobile", "Tablet"], "datasets": [{"data": [55, 35, 10]}] }, "title": "Traffic by Device", "theme": "colorful" } ``` **Example - Scatter Plot (Academic, SVG):** ```json { "action": "generate_chart", "chart_type": "scatter", "data": { "datasets": [{ "label": "Sample Data", "data": [{"x": 10, "y": 20}, {"x": 15, "y": 25}, {"x": 20, "y": 22}, {"x": 25, "y": 30}] }] }, "title": "Correlation Analysis", "theme": "academic", "width": 700, "height": 500, "output_format": "svg" } ``` **Example - Custom Styled Chart:** ```json { "action": "generate_chart", "chart_type": "bar", "data": { "labels": ["Mon", "Tue", "Wed", "Thu", "Fri"], "datasets": [{"label": "Tasks Completed", "data": [5, 8, 12, 7, 10]}] }, "title": "Weekly Productivity", "theme": "custom", "background_color": "#F5F5F5", "custom_options": { "plugins": {"legend": {"display": false}}, "scales": {"y": {"beginAtZero": true, "grid": {"color": "rgba(0, 0, 0, 0.1)"}}} } } ``` **Example - Base64 Return (No File Storage):** ```json { "action": "generate_chart", "chart_type": "line", "data": { "labels": ["1", "2", "3", "4", "5"], "datasets": [{"label": "Values", "data": [10, 20, 15, 25, 30]}] }, "theme": "minimal", "return_base64": true, "store_file": false } ``` **Example - PDF Export with Custom Expiration:** ```json { "action": "generate_chart", "chart_type": "bar", "data": { "labels": ["Category A", "Category B", "Category C"], "datasets": [{"label": "Results", "data": [65, 85, 75]}] }, "title": "Survey Results", "theme": "corporate", "output_format": "pdf", "width": 800, "height": 600, "expiration_days": 3 } ``` **Response fields:** - `chart_type`: Chart type used - `theme`: Theme applied - `format`: Output format - `width`, `height`: Dimensions - `size_bytes`: File size in bytes - When `return_base64` is true: `base64_data` (string), `content_type` (MIME type) - When `store_file` is true: `file_id` (string), `signed_url` (temporary download URL), `expiration_date` (ISO date) --- #### Data Format Standard chart types (bar, line, pie, doughnut, radar, polarArea, horizontalBar): ```json { "labels": ["Label 1", "Label 2", "Label 3"], "datasets": [{ "label": "Dataset Name", "data": [10, 20, 30], "backgroundColor": "optional color override", "borderColor": "optional border color", "borderWidth": 1 }] } ``` Scatter and bubble charts use point objects instead of simple values: ```json { "datasets": [{ "label": "Points", "data": [{"x": 10, "y": 20}, {"x": 15, "y": 25}] }] } ``` Multiple datasets are supported. Theme colors are auto-assigned to datasets that do not specify their own colors. --- #### Workflows 1. **Business Dashboard Chart** - Use `generate_chart` with `theme: "corporate"`, a bar or line chart, and `store_file: true` to get a signed URL for embedding in reports. 2. **Email-Embedded Chart** - Use `generate_chart` with `return_base64: true` and `store_file: false` to get base64 data for inline embedding in emails. 3. **Scientific Publication Figure** - Use `generate_chart` with `theme: "academic"`, `output_format: "svg"` for scalable vector output suitable for print. 4. **Marketing Infographic** - Use `generate_chart` with `theme: "colorful"`, pie or doughnut chart, and `device_pixel_ratio: 2` for high-resolution social media images. 5. **Dark Mode Presentation Slide** - Use `generate_chart` with `theme: "modern_dark"`, large dimensions (1920x1080), and `device_pixel_ratio: 2`. 6. **Custom Branded Chart** - Use `theme: "custom"` with `custom_options` to apply your own colors, fonts, grid styles, and legend placement. --- #### Notes - Maximum chart dimensions are 2000x2000 pixels. - Stored files expire after 1-7 days (configurable via `expiration_days`). - The `data` object must contain at least a `datasets` array. The `labels` array is required for most chart types but not for scatter/bubble charts. - When using `theme: "custom"`, no preset styling is applied. Combine with `custom_options` for full control. - `custom_options` merges on top of theme defaults, so you can start with a theme and override specific options. - The `device_pixel_ratio: 2` option doubles the rendered resolution (useful for retina displays) but also increases file size. - If both `return_base64: true` and `store_file: true` are set, you get both the base64 data and a stored file URL. - Validation: `chart_type` and `data` are required for `generate_chart`. Missing either returns a 400 error. - Recommended sizes: social media 800x600, reports 1000x600, presentations 1920x1080. ## When To Use - Use this skill for `Chart Generator` on AgentPMT. - Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape. - Search and activation keywords: chart generator, create business dashboards with professional charts, generate marketing reports with colorful visualizations, build presentation slides with modern dark themed graphs, produce academic papers with publication quality figures, generate chart, chart type, data. - Supported action names: `generate_chart`. ## Use Cases - Create business dashboards with professional charts - Generate marketing reports with colorful visualizations - Build presentation slides with modern dark-themed graphs - Produce academic papers with publication-quality figures - Design social media infographics with custom styling - Automate report generation with data-driven charts - Create real-time monitoring dashboards - Generate email campaign analytics visualizations - Build data analysis notebooks with embedded charts - Produce financial reports with professional formatting ## Related Product Skills - File Management: ../file-management (ClawHub: `file-management`, page: https://clawhub.ai/agentpmt/file-management; skills.sh: `npx skills add AgentPMT/agent-skills --skill file-management`)