Back to Skills

vega

Create data-driven charts with Vega-Lite (declarative) and Vega (programmatic). Best for statistical visualization of numeric data — bar, line, scatter, heatmap, area, radar charts, and word clouds.

2,909stars171forksUpdated 6/8/2026

Security Assessment

Safe(100/100)
Security Score100/100

About vega

The vega skill helps users create data-driven charts using Vega-Lite and Vega inside Markdown code fences. It solves the problem of turning structured data into valid, renderable statistical visualizations by guiding users through the core workflow: organize data as an array of objects, choose an appropriate mark type, map visual encodings to fields, and declare correct data types. The skill emphasizes reliable chart rendering by enforcing schema inclusion, valid JSON syntax, exact field-name matching, and supported Vega-Lite data types.

Its main capabilities include generating Vega-Lite charts for common visualization needs such as bar charts, line charts, scatter plots, heatmaps, area charts, and other numeric-data visualizations. It also supports full Vega for more advanced or programmatic chart types, specifically where Vega-Lite is not the preferred fit, such as radar charts, word clouds, and force-directed visualizations. The skill provides critical syntax rules, common troubleshooting guidance, and the required Markdown output format using either vega-lite or vega fences.

This skill is useful for analysts, technical writers, data storytellers, Markdown users, and developers who need portable, declarative chart specifications in documentation or reports. It is especially suited for users who want to embed statistical visualizations directly in Markdown while avoiding common rendering mistakes. The skill is best for numeric and structured data visualization, with Vega-Lite recommended for most charts and Vega reserved for advanced patterns that require lower-level control.

FAQ

When should I use Vega-Lite instead of Vega?

Use Vega-Lite for most charts, including bar, line, scatter, heatmap, and area charts. Use full Vega only for advanced visualizations mentioned in the skill content, such as radar charts, word clouds, and force-directed charts.

What output format does this skill require?

The chart specification should be wrapped in a Markdown code fence using either vega-lite for Vega-Lite charts or vega for full Vega charts.

What are the most important syntax requirements?

Always include the appropriate $schema field, use valid JSON with double-quoted keys and no trailing commas, match field names exactly as they appear in the data, and use valid data types such as quantitative, nominal, ordinal, or temporal.

Why might a chart fail to render?

Common causes include invalid JSON, a missing $schema field, field names that do not exactly match the data, an incompatible mark choice, low-contrast colors, or unresolved scale issues in dual-axis charts.

What kinds of data is this skill best suited for?

It is best suited for structured data represented as arrays of objects, especially numeric or statistical data that can be mapped to chart encodings such as x, y, color, and size.

All Files

2 files
references/examples.md8.7 KB
View
SKILL.md2.1 KB
View

Install vega

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill