Schema JSON Structure URI
schema-json-structure-uri
info
experience: consistencyexperience: discoverability
spec: schemas
$schema should be a URI.
$schema should be the URI of the JSON Structure meta-schema.
Rule definition
The full Spotlight rule — drop it into a ruleset (.spotlight.yaml / .spectral.yaml) and run it with any Spotlight tool.
schema-json-structure-uri:
title: Schema JSON Structure URI
reference: https://spotlight-rules.com/spec/rules/json-structure/schema-json-structure-uri/
description: $schema should be the URI of the JSON Structure meta-schema.
message: $schema should be a URI.
given: $.$schema
severity: info
then:
function: pattern
functionOptions:
match: ^https?://
tags:
- format:json-structure
- spec:schemas
- experience:consistency
- experience:discoverability
prompt: "You are editing a JSON Structure document to satisfy the Spotlight API
governance rule 'schema-json-structure-uri' (Schema JSON Structure URI).
Requirement: $schema should be the URI of the JSON Structure meta-schema. To
fix: Ensure the targeted value matches the regular expression `^https?://`;
rewrite any value that does not. This rule is evaluated at the JSONPath
`$.$schema` — inspect every location it matches and correct only what
violates the rule. Make the smallest change that satisfies the rule, leave
all unrelated content, key order, comments, and formatting unchanged, and
keep the document valid JSON Structure. Return only the complete corrected
document, with no commentary."
AI fix prompt — send this to Claude, Gemini, or ChatGPT with your artifact to auto-fix this rule
You are editing a JSON Structure document to satisfy the Spotlight API governance rule 'schema-json-structure-uri' (Schema JSON Structure URI). Requirement: $schema should be the URI of the JSON Structure meta-schema. To fix: Ensure the targeted value matches the regular expression `^https?://`; rewrite any value that does not. This rule is evaluated at the JSONPath `$.$schema` — inspect every location it matches and correct only what violates the rule. Make the smallest change that satisfies the rule, leave all unrelated content, key order, comments, and formatting unchanged, and keep the document valid JSON Structure. Return only the complete corrected document, with no commentary.
| Artifact | JSON Structure |
|---|---|
| Applies at (given) | $.$schema |
| Severity | info — educational by default; raise to warn/error to enforce |
| Reference | https://spotlight-rules.com/spec/rules/json-structure/schema-json-structure-uri/ |