writing-json-schemas

What problem does it solve?

Authors writing JSON Schemas for z-schema validation face the challenge of producing correct, reusable, and forward-compatible schemas that reflect the latest draft standards while supporting complex constructs like $ref, $defs, oneOf/anyOf/if-then-else, and array/item constraints. This Skill provides templates, patterns, and guidance to write accurate schemas that validate data consistently across APIs, forms, and payload schemas.

Core Features & Use Cases

• Template-driven schemas with a standard header, including $schema and type declarations.
• Structured object and nested schemas using $ref and $defs for reusable definitions.
• Support for arrays via items and prefixItems, and advanced constraints like format, contains, and patternProperties.
• Schema composition and conditional logic using anyOf, oneOf, allOf, not, and if/then/else for flexible validation.

Quick Start

Create a draft-2020-12 object schema with required fields name and email, and validate a sample payload against it using z-schema.