jqschema

Name: jqschema
Author: github/gh-aw

$npx mdskill add github/gh-aw/jqschema

Discover JSON structure and types using jq-based schema discovery

Identifies unknown JSON structures by analyzing input data.
Deploys `jq` for parsing and extracting key information from JSON inputs.
Decides on appropriate type mappings based on detected values (string, number, boolean, null).
Delivers a compact schema representation of the discovered structure to users or agents.

SKILL.md

.github/skills/jqschemaView on GitHub ↗

---
name: jqschema
description: Infer JSON structure and types with jq-based schema discovery.
tools:
  bash:
    - "jq *"
    - "./.github/skills/jqschema/jqschema.sh"
    - "git"
---

## 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.

```bash
# 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"}]}`

More from github/gh-aw

Skill	Description
agentic-workflow-designer	Conversational skill that interviews users to design new agentic workflows
aw-value	Design and verify a deterministic operational-value grader for a GitHub Agentic Workflow. Use for per-run operational value, evidence attribution, maturation, baselines, and operational-value evaluators. Usage: /aw-value OWNER/REPO WORKFLOW-NAME.
awf-release-integrator	Upgrade gh-aw to latest gh-aw-firewall release and identify follow-up spec tasks.
checkout-credential-review	Review code that performs git or gh operations against repository checkouts in gh-aw, checking that the right credentials are available at the right time and that sparseness, shallowness and credential-free factors are properly considered.
console-rendering	Use Go struct tags to render styled terminal output in gh-aw.
copilot-review	Teach Copilot how to plan, address, and respond to pull request review feedback.
create-canvas	Author, validate, and debug canvas extensions that the agent can open in the GitHub Copilot app's side panel. Use when creating, reviewing, or troubleshooting a canvas extension — including its actions, inputs, rendered content, and the surrounding extension wiring (tools, hooks, lifecycle).
custom-agents	Define and validate GitHub custom agent files, prompts, and examples.
custom-engine-implementation	Add and test declarative behavior-defined agentic engines in gh-aw, extending Go infrastructure only when necessary.
debugging-workflows	Diagnose gh-aw failures using the canonical debugging strategy and evidence reference.