| name | schema-meta |
| description | Validate that a JSON Schema is well-formed and conforms to the JSON Schema specification. Use when the user asks to check if a schema is valid, verify schema syntax, validate schema structure, or check a JSON Schema file for errors. |
Validate JSON Schema (Meta-Validation)
Validate that a JSON Schema document is itself a valid schema according to the JSON Schema specification.
Usage
npx tsx scripts/meta-validate.ts <schema-file> [options]
Arguments
| Argument | Required | Description |
|---|
schema-file | Yes | Path to the JSON Schema file to validate |
Options
| Option | Description |
|---|
--draft=VERSION | JSON Schema draft version (draft-04, draft-06, draft-07, 2019-09, 2020-12). Default: auto-detect |
--strict | Enable strict mode (additional validation rules) |
--verbose | Show detailed validation information |
Output
Valid schema:
Valid JSON Schema (draft-2020-12)
Keywords: 5
Definitions: 2
Invalid schema:
Invalid JSON Schema
Error: "type" must be a string or array
Path: /properties/name/type
Script Execution
npx tsx scripts/meta-validate.ts schema.json
npx tsx scripts/meta-validate.ts schema.json --draft=draft-07
npx tsx scripts/meta-validate.ts schema.json --strict --verbose
Run from the json-schema plugin directory: ~/.claude/plugins/cache/json-schema/
Draft Version Detection
The script auto-detects the JSON Schema draft version from:
- The
$schema keyword in the document
- Falls back to draft-2020-12 if not specified
Supported drafts:
draft-04 - JSON Schema Draft 4
draft-06 - JSON Schema Draft 6
draft-07 - JSON Schema Draft 7
2019-09 - JSON Schema Draft 2019-09
2020-12 - JSON Schema Draft 2020-12 (default)
Strict Mode
When --strict is enabled, additional validations are performed:
- Disallow unknown keywords
- Require
$schema declaration
- Validate format assertions by default
Related Skills
- Use
schema-validate to validate JSON data against a schema
- Use
schema-check to validate a JSON file against its embedded $schema