vega-lite-validator-0-1-0

name	vega-lite-validator-0-1-0
description	Validates Vega-Lite 6.4.3 JSON specifications against the official JSON Schema using check-jsonschema. Catches structural errors, invalid field types, and missing required properties before rendering. Use when validating Vega-Lite specs generated by applications, pipelines, or agents, or debugging schema violations in visualization definitions.

Vega-Lite Validate (v6.4.3)

Overview

Validates Vega-Lite 6.4.3 specification files against the official JSON Schema using check-jsonschema (a Python CLI built on the jsonschema library). The Vega-Lite schema (~1.8 MB, JSON Schema Draft-07) is shipped with this skill in assets/vega-lite-schema.json, so validation works offline without network access.

When to Use

• Validating a Vega-Lite spec before passing it to a renderer (Vega, vega-lite npm package, Altair, etc.)
• Debugging schema violations in programmatically generated visualization definitions
• CI/CD checks on JSON specs stored in repositories
• Verifying specs received from external applications or APIs

Usage

Run the validation script with a path to the Vega-Lite spec file:

bash scripts/vega-lite-validate.sh instance.json

The script resolves assets/vega-lite-schema.json relative to its own location, so it works correctly regardless of the current working directory.

Exit Codes

Code	Meaning
0	Spec is valid under the Vega-Lite schema
1	Validation failed — schema errors found
2	Usage error (missing argument, missing files)

Output on Success