Materials CLI

Use this skill when the user wants to render JSON schemas to images (PNG/JPG), validate render-data schemas, or generate schemas from natural-language prompts and then render them.

Commands

• - render — Render a JSON schema file to an image.
• generate — Use AI (OpenAI) to generate a schema from a prompt, then render it.
• validate — Validate a JSON schema against the declare-render data schema.

When to use

• - User asks to "render a schema to image", "turn JSON into a picture", or "draw from schema".
• User wants to "generate an image from a description" or "create a schema from a prompt" and render it.
• User wants to "validate" a JSON file against the render data schema.

Usage

Run via Node (from the project or after npm install -g materials-cli):

CODEBLOCK0

Render

• - INLINECODE1
• Options: -s, --schema <path>, -o, --output <path> (default ./output.png), -f, --format <png|jpg>, -w, --width, -h, --height, --output-schema <path>, INLINECODE9

Generate (AI)

• - INLINECODE10
• Options: -o, --output, -f, --format, -w, --width, -h, --height, --output-schema, --model, --api-key, --base-url, INLINECODE19
• Uses OPENAI_API_KEY (and optionally OPENAI_MODEL, OPENAI_BASE_URL) if not passed via flags.

Validate

• - INLINECODE23
• Options: -s, --schema <path>, INLINECODE25

CLI help

CODEBLOCK1

Schema format

The JSON schema follows the declare-render format: root has id, width, height, and layers. Layer types include text, image, and shape. Use materials validate <file> to check a schema before rendering.