json-inspect

name	json-inspect
description	Generates JSON Schema from JSON files using genson to understand data structure. Triggers on "inspect JSON", "understand JSON format", "analyze JSON data shape", "generate JSON schema", or mentions "genson".
allowed-tools	Bash(uvx:*), Read
effort	low
argument-hint	[json-file-path]

JSON Schema Inspection

Generate JSON Schema from any JSON file to understand its structure.

Quick Start

uvx genson <JSON_FILE>

This outputs a JSON Schema describing the file's structure, including:

• Required vs optional fields
• Data types for each field
• Array item types
• Nested object structures

Example

For a file data.json:

{ "name": "Alice", "age": 30, "tags": ["dev", "lead"] }

Running uvx genson data.json produces (compact, single-line by default; add -i 2 for the pretty-printed form shown here):

{
  "$schema": "http://json-schema.org/schema#",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["age", "name", "tags"]
}

Use Cases

• Understanding unfamiliar JSON data structures
• Documenting API response formats
• Validating JSON against expected schema
• Generating TypeScript interfaces from JSON