Infers compact JSON structural schemas with keys and types using jq.
npx skills add https://github.com/github/gh-aw --skill jqschema
Please help me install this Agent Skill. Skill: jqschema Source: https://github.com/github/gh-aw/tree/main/.github/skills/jqschema Command: npx skills add https://github.com/github/gh-aw --skill jqschema
Exploring unknown JSON APIs or large payloads is slow when you must inspect full data just to learn its shape. This Skill condenses any JSON input into a compact structural schema showing keys and value types, so you can understand the data before writing queries.
gh api search/repositories?q=language:go through the script with perPage=1 to instantly see the response structure instead of reading thousands of lines of raw JSON.Pipe any JSON output through ./.github/skills/jqschema/jqschema.sh to see its compact structural schema.
High-intent search queries and answers about installing and using this skill.
Pipe the API response through the jqschema.sh script, for example: gh api search/repositories?q=language:go | ./jqschema.sh. It outputs a compact schema where each value is replaced by its type name, so you see keys and types without the full data.
Use the provided jqschema.sh script, which runs a jq program that recursively walks the JSON, replacing object values with type names like string or number and reducing arrays to their first element's structure. Feed it JSON via stdin from a file or command.
Yes, the script recursively walks nested objects and arrays. Arrays are reduced to the structure of their first element, and empty arrays are returned as empty arrays, so deeply nested JSON still produces a compact schema.
The output shows only structural types, not full JSON Schema with constraints, formats, or required fields. Arrays are represented by their first element only, so heterogeneous arrays may be misrepresented. Use it for quick exploration, not formal validation.
The script requires bash and the jq command-line JSON processor. No other packages are needed; it runs as a single self-contained shell script that reads JSON from stdin.
starwardsQuery GitHub repositories, PRs, issues, and workflows via the gh CLI.
joshka0Read and write repository files while querying JSON/YAML content with jq.
f4rkh4dValidate untrusted inputs against explicit schemas at trust boundaries.
vladm3105Create Layer 9 Data Contracts with Markdown and YAML files.