One-click install
npx skills add https://github.com/hschne/pi-stuff --skill jq-hschne
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jq
Source: https://github.com/hschne/pi-stuff/tree/main/skills/jq
Command: npx skills add https://github.com/hschne/pi-stuff --skill jq-hschne

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually parsing, extracting, and transforming JSON data from files, API responses, CLI output, and logs is time-consuming and prone to human error, especially when working with large or deeply nested JSON structures.

Core Features & Use Cases

  • JSON Querying & Filtering: Extract nested fields, filter arrays and objects by custom conditions, and select only the required data from large JSON datasets.
  • JSON Reshaping & Conversion: Rename fields, merge multiple JSON files, and convert JSON output to shell-friendly formats like CSV or TSV for use in downstream scripts.
  • Common Use Cases: Process GitHub CLI JSON output, parse API response data, validate JSON configuration files, and extract error messages from application logs.

Quick Start

Use the jq skill to extract all active user email addresses from the provided users.json file and output them as a plain, newline-separated list.

Frequently Asked Questions about jq

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract specific fields from a large JSON file?

You can extract specific fields from a JSON file by applying JSON filtering queries to select nested data. This approach allows you to filter arrays and objects by custom conditions, pulling only the required data from large datasets without manual parsing.

What is the best way to parse API response data in JSON format?

The best way to parse API response data is by applying deterministic JSON query operations. This allows you to validate, reshape, and extract specific values from API payloads directly within data pipelines without manual parsing.

Can I convert JSON output to CSV format for shell scripts?

Yes, JSON output can be converted to shell-friendly formats like CSV or TSV. By reshaping and converting your JSON data, you generate formats readily usable by downstream shell scripts and CLI tools.

Do I need the jq command-line tool installed to process JSON data?

Yes, the jq command-line tool is required to execute deterministic JSON processing operations. This dependency ensures precise extraction, reshaping, merging, and validation of structured JSON content across workflows.

How do I filter error messages from application logs in JSON?

Filtering error messages from application logs in JSON involves querying the structured log data. You can extract specific nested fields and filter objects by custom conditions to isolate error messages from large JSON datasets.

Why does manually parsing deeply nested JSON structures cause errors?

Manually parsing deeply nested JSON structures is time-consuming and prone to human error. Automating JSON data transformation and querying ensures deterministic extraction and reshaping, eliminating manual parsing mistakes across development workflows.