# Jq Processor

> Transform, filter, and reshape JSON data using jq — the lightweight command-line JSON processor. Ideal for extracting fields from API responses, transforming CI artifact payloads, and scripting data pipelines.

- Skill: `loonghao/jq-processor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add loonghao/jq-processor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/loonghao/jq-processor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: loonghao (https://skillmd.com/u/loonghao)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/loonghao/jq-processor

---


# jq JSON Processor

Transform and filter JSON data using [jq](https://stedolan.github.io/jq),
the lightweight and flexible command-line JSON processor.

## When to use

- Extracting specific fields from REST API responses in CI scripts
- Reshaping JSON payloads before forwarding to downstream services
- Generating human-readable summaries from structured data
- Validating JSON schema compliance in test pipelines

## Inputs

```json
{
  "input": { "users": [{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}] },
  "filter": ".users[] | select(.age > 26) | .name",
  "compact": false
}
```

| Field     | Required | Description                                              |
|-----------|----------|----------------------------------------------------------|
| `input`   | ✓        | JSON object or array to process                          |
| `filter`  | ✓        | jq filter expression                                     |
| `compact` | ✗        | Output compact JSON without pretty-printing (default: false) |
| `raw`     | ✗        | Output raw strings instead of JSON (default: false)      |

## Common filters

```bash
# Extract all artifact IDs from a registry response
echo $RESPONSE | jq '[.items[].id]'

# Filter skills by tag
echo $SKILLS | jq '[.[] | select(.tags | contains(["ci"]))]'

# Format a summary table
echo $DATA | jq -r '.[] | "\(.name)\t\(.version)"'

# Merge two JSON objects
jq -n --argjson a "$OBJ_A" --argjson b "$OBJ_B" '$a + $b'
```

## Output

```json
{
  "result": "Alice",
  "elapsed_ms": 2
}
```