OpenParable
Skip to content
← Back to skills

Charts

Design
charts

Charts is an Agent Skill for design published in the BuilderIO/agent-native repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generate inline chart images (PNG) for embedding in chat responses. Use this skill when you need to create bar, line, or area charts for data visualization in chat.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/BuilderIO/agent-native/blob/HEAD/templates/analytics/.builder/skills/charts/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/charts, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Chart Generation

How It Works

Charts are generated server-side as PNG images using chartjs-node-canvas (Chart.js) and served via /api/media/. The generate-chart script renders charts and returns a fully qualified URL for embedding in chat markdown.

Script Usage

pnpm action generate-chart --type=bar --title="Title" --labels='["A","B","C"]' --data='[1,2,3]' --color="#18B4F4"

Parameters

ParamValuesDefault
--typebar, line, areabar
--titleChart title (keep SHORT)required
--subtitleOptional subtitle — avoid unless needed—
--labelsJSON array of x-axis labelsrequired
--dataJSON array of numbers, OR array of {label, data, color} for multi-seriesrequired
--colorPrimary hex color#18B4F4
--themedark, lightauto from /api/theme
--stackedtrue for stacked barsfalse
--filenameOutput filename (no ext)auto from title
--width / --heightImage dimensions800x400

Output

{ filename, url, width, height } — the url is fully qualified with cache buster.

Color Palette

ColorHexUse
Blue#18B4F4Default/primary for all charts
Purple#8b5cf6Secondary
Green#22c55eTertiary
Amber#f59e0b
Indigo#6366f1
Red#ef4444
Teal#14b8a6
Orange#f97316

Style Preferences (from Steve)

  • Minimal text on chart — short title only, no subtitle
  • Stats and context in chat text around the chart, not on the image
  • Large fonts: title 22px, axis 13px
  • Few axis labels: maxTicksLimit 8 on x-axis, 5 on y-axis
  • No rotated labels (maxRotation: 0)

Good pattern:

**Example Corp Product Usage — Last 30 Days**
![chart](https://...your-app.example.com/api/media/chart.png?v=123)
**528 messages** over 18 active days | Peak: **89** (Feb 14)

QuickChart Inline Styling (for non-script charts)

When using QuickChart (https://quickchart.io/chart/create) with Chart.js v2:

  • Background: #09090b (zinc-950)
  • Grid: horizontal only, dashed [3,3], color #27272a
  • Axis ticks: #52525b, 11px
  • Title: #fafafa, 16px bold
  • Legend: #a1a1aa, 11px
  • Default bar/line color: #18B4F4 (primary blue)
  • Tooltips: bg #09090b, border #27272a, text #fafafa

Multi-Series & Stacked Charts

  • Use --stacked=true flag
  • Pass data as --data='[{"label":"User A","data":[...],"color":"#..."}]'
  • Script sets stack: "stack1" on all datasets

Key Gotchas

  • Relative paths do NOT work — chat UI is on a different origin. Always use the fully qualified URL from script output (uses APP_ORIGIN)
  • Cache busting (?v=<timestamp>) auto-appended
  • chartjs-node-canvas depends on canvas native module — pnpm.onlyBuiltDependencies must include "canvas". If not built, run pnpm rebuild canvas
  • Theme auto-detected from media/theme.json (set by sidebar toggle via POST /api/theme)