Labsco
github logo

jqschema

โœ“ Officialโ˜… 4,723

by github ยท part of github/gh-aw

Infer JSON structure and types with jq-based schema discovery.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeQuick setup
๐Ÿงฐ Not standalone. This skill ships with github/gh-aw and only works together with that tool โ€” install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates โ€” you don't need to read it to use the skill, but it's here to audit before installing.

jqschema - JSON Schema Discovery

Use ./.github/skills/jqschema/jqschema.sh to generate a compact structural schema (keys + types) from JSON input. Pipe any JSON source through it to discover structure before querying full data.

# Analyze a file or command output
cat data.json | ./.github/skills/jqschema/jqschema.sh
gh api search/repositories?q=language:go | ./.github/skills/jqschema/jqschema.sh

The script replaces object values with type names ("string", "number", "boolean", "null"), reduces arrays to first-element structure, and outputs compact JSON. Use perPage: 1 to fetch minimal data when exploring unknown API shapes.

Example: {"total_count":1000,"items":[{"login":"user1","id":123}]} โ†’ {"total_count":"number","items":[{"login":"string","id":"number"}]}