---
name: demo-json-schema-helper
description: Use when an agent needs to draft or review compact JSON schemas for API request and response payloads.
version: 0.1.0
---

# Demo JSON Schema Helper

When drafting a schema:

- Keep required fields minimal.
- Prefer explicit enums for workflow states.
- Use descriptions only where they prevent misuse.
- Add one valid and one invalid example when the field semantics are subtle.

Return the schema first, then a short rationale.