Back to skills
extension
Category: Development & EngineeringNo API key required

schema-meta

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.

personAuthor: jakexiaohubgithub

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:

  1. The $schema keyword in the document
  2. 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