К основному содержанию
скилл CX Codex

jq-json-processing — скилл для Claude Code: парсинг и фильтры JSON

Скилл jq-json-processing для парсинга, фильтрации и трансформации JSON через jq. Извлекает поля, фильтрует массивы, перестраивает объекты и валидирует синтаксис.

MIT 245 установок ★ 60 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add laurigates/claude-plugins --skill jq-json-processing -a claude-code
Открыть на GitHub

Что делает jq-json-processing

Скилл даёт агенту экспертные знания jq — утилиты для работы с JSON в терминале. Внутри примеры запросов, фильтров и трансформаций: от простого извлечения полей (jq '.user.email') до группировки и агрегации (group_by(.status)). Агент умеет фильтровать массивы по условиям, сортировать, объединять объекты, работать со строками и вложенными структурами.

В скилле описаны паттерны для частых задач: извлечь все email из вложенной структуры (.. | .email? // empty), посчитать элементы по статусу, преобразовать API-ответ в простой список, слить два JSON-файла. Для больших файлов агент знает, как не загружать их целиком. Без jq в системе скилл работать не будет — утилита должна быть установлена заранее.

Для YAML и многошаговых трансформаций поверх CSV и TOML есть отдельные скиллы — yq-yaml-processing и nushell-data-processing.

Какие задачи решает

  • достать email из вложенной структуры JSON
  • отфильтровать массив по значению поля
  • слить два JSON-файла в один
  • посчитать количество элементов по статусу
  • преобразовать API-ответ в плоский список объектов

Примеры запросов агенту

  • Извлеки все активные элементы из items в data.json и выведи их названия
  • Отфильтруй users.json по возрасту старше 18 и запиши результат в adults.json
  • Посчитай, сколько элементов в каждой группе по статусу в logs.json

Как установить jq-json-processing

1Через Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill jq-json-processing -a claude-code

2Вручную: положить файлы

~/.claude/skills/jq-json-processing/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/jq-json-processing/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о jq-json-processing

Как установить jq-json-processing в Claude Code?

Запусти npx skills add laurigates/claude-plugins --skill jq-json-processing -a claude-code, скилл появится в ~/.claude/skills/jq-json-processing/SKILL.md.

Что делает jq-json-processing?

Скилл учит агента парсить, фильтровать и трансформировать JSON через утилиту jq. Извлекает поля, фильтрует массивы по условиям, перестраивает объекты, группирует данные.

Когда использовать jq-json-processing вместо yq-yaml-processing?

Для JSON-файлов и вывода API (gh, curl, kubectl -o json) — jq-json-processing. Для YAML (Kubernetes, GitHub Actions, Helm) и редактирования с сохранением комментариев — yq-yaml-processing.

Исходный текст

SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-05-04
reviewed: 2026-04-25
name: jq-json-processing
description: "jq JSON processing: query, filter, transform JSON. Use when parsing JSON files, filtering arrays/objects, transforming structures, or extracting fields from JSON."
user-invocable: false
allowed-tools: Bash(jq *), Bash(cat *), Read, Write, Edit, Grep, Glob
model: sonnet
---

# jq JSON Processing

Expert knowledge for processing, querying, and transforming JSON data using jq, the lightweight and flexible command-line JSON processor.

## When to Use This Skill

| Use this skill when... | Use yq-yaml-processing instead when... |
|---|---|
| Extracting or filtering fields in JSON input | Working with YAML files (Kubernetes, GH Actions, Helm) |
| Parsing `gh`, `curl`, or `kubectl -o json` responses | Editing YAML in place while preserving comments |
| CI pipelines on minimal images (jq is universally installed) | Converting YAML → JSON before processing |

| Use this skill when... | Use nushell-data-processing instead when... |
|---|---|
| One-off pipeline transforms that fit in a single expression | Multi-step transforms that span JSON, YAML, CSV, and TOML |
| Stdin-piped JSON from another command | Aggregations, group-by, or visual table exploration |

## Core Expertise

**JSON Operations**
- Query and filter JSON with path expressions
- Transform JSON structure and shape
- Combine, merge, and split JSON data
- Validate JSON syntax and structure

**Data Extraction**
- Extract specific fields from JSON objects
- Filter arrays based on conditions
- Navigate nested JSON structures
- Handle null values and missing keys

## Essential Commands

### Basic Querying

```bash
# Pretty-print JSON
jq '.' file.json

# Extract specific field
jq '.fieldName' file.json

# Extract nested field
jq '.user.email' file.json

# Extract array element
jq '.[0]' file.json
jq '.items[2]' file.json
```

### Array Operations

```bash
# Get array length
jq '.items | length' file.json

# Map over array
jq '.items | map(.name)' file.json

# Filter array
jq '.items[] | select(.active == true)' file.json
jq '.users[] | select(.age > 18)' file.json

# Sort array
jq '.items | sort_by(.name)' file.json
jq '.items | sort_by(.date) | reverse' file.json

# Get first/last elements
jq '.items | first' file.json
jq '.items | last' file.json

# Unique values
jq '.tags | unique' file.json
```

### Object Operations

```bash
# Get all keys
jq 'keys' file.json
jq '.config | keys' file.json

# Get all values
jq '.[] | values' file.json

# Select specific fields
jq '{name, email}' file.json
jq '{name: .fullName, id: .userId}' file.json

# Add field
jq '. + {newField: "value"}' file.json

# Delete field
jq 'del(.password)' file.json

# Merge objects
jq '. * {updated: true}' file.json
```

### Filtering and Conditions

```bash
# Select with conditions
jq 'select(.status == "active")' file.json
jq '.[] | select(.price < 100)' file.json

# Multiple conditions (AND)
jq '.[] | select(.active and .verified)' file.json
jq '.[] | select(.age > 18 and .country == "US")' file.json

# Multiple conditions (OR)
jq '.[] | select(.type == "admin" or .type == "moderator")' file.json

# Exists / has field
jq '.[] | select(has("email"))' file.json
jq 'select(.optional != null)' file.json

# Not condition
jq '.[] | select(.status != "deleted")' file.json
```

### String Operations

```bash
# String interpolation
jq '"Hello, \(.name)"' file.json

# Convert to string
jq '.id | tostring' file.json

# String contains
jq '.[] | select(.email | contains("@gmail.com"))' file.json

# String starts/ends with
jq '.[] | select(.name | startswith("A"))' file.json
jq '.[] | select(.file | endswith(".json"))' file.json

# Split string
jq '.path | split("/")' file.json

# Join array to string
jq '.tags | join(", ")' file.json

# Lowercase/uppercase
jq '.name | ascii_downcase' file.json
jq '.name | ascii_upcase' file.json
```

### Pipes and Composition

```bash
# Chain operations
jq '.items | map(.name) | sort | unique' file.json

# Multiple filters
jq '.users[] | select(.active) | select(.age > 18) | .email' file.json

# Group by
jq 'group_by(.category)' file.json
jq 'group_by(.status) | map({status: .[0].status, count: length})' file.json
```

### Output Formatting

```bash
# Compact output (no pretty-print)
jq -c '.' file.json

# Raw output (no quotes for strings)
jq -r '.message' file.json
jq -r '.items[] | .name' file.json

# Output as tab-separated values
jq -r '.[] | [.name, .age, .email] | @tsv' file.json

# Output as CSV
jq -r '.[] | [.name, .age, .email] | @csv' file.json

# Output as JSON array on one line
jq -c '[.items[]]' file.json
```

### Input/Output Options

```bash
# Read from stdin
cat file.json | jq '.items'
curl -s https://api.example.com/data | jq '.results'

# Multiple input files
jq -s '.' file1.json file2.json  # Slurp into array

# Write to file
jq '.filtered' input.json > output.json

# In-place edit (use sponge from moreutils)
jq '.updated = true' file.json | sponge file.json
```

### Advanced Patterns

```bash
# Recursive descent
jq '.. | .email? // empty' file.json

# Reduce (sum, accumulate)
jq '[.items[].price] | add' file.json
jq 'reduce .items[] as $item (0; . + $item.price)' file.json

# Variable assignment
jq '.items[] | . as $item | $item.name + " - " + ($item.price | tostring)' file.json

# Conditional (if-then-else)
jq '.items[] | if .price > 100 then "expensive" else "affordable" end' file.json
jq 'if .error then .error else .data end' file.json

# Try-catch for error handling
jq '.items[] | try .field catch "not found"' file.json

# Flatten nested arrays
jq '.items | flatten' file.json
jq '.items | flatten(1)' file.json  # Flatten one level
```

### Real-World Examples

```bash
# Extract all emails from nested structure
jq '.. | .email? // empty' users.json

# Get unique list of all tags across items
jq '[.items[].tags[]] | unique' data.json

# Count items by status
jq 'group_by(.status) | map({status: .[0].status, count: length})' items.json

# Transform API response to simple list
jq '.results[] | {id, name: .full_name, active: .is_active}' response.json

# Filter GitHub workflow runs (recent failures)
gh run list --json status,conclusion,name,createdAt | \
  jq '.[] | select(.conclusion == "failure") | {name, createdAt}'

# Extract package.json dependencies with versions
jq '.dependencies | to_entries | map("\(.key)@\(.value)")' package.json

# Merge two JSON files
jq -s '.[0] * .[1]' base.json override.json

# Create summary from log data
jq 'group_by(.level) | map({level: .[0].level, count: length, samples: [.[].message][:3]})' logs.json
```

## Best Practices

**Query Construction**
- Start simple, build complexity incrementally
- Test filters on small datasets first
- Use `-c` flag for compact output in scripts
- Use `-r` flag for raw strings (no quotes)

**Performance**
- Use `select()` early in pipeline to reduce data
- Use targeted queries with specific paths for large files
- Stream large JSON with `--stream` flag
- Consider `jq -c` for faster processing

**Error Handling**
- Use `?` operator for optional access: `.field?`
- Use `// empty` to filter out nulls/errors
- Use `try-catch` for graceful error handling
- Check for field existence with `has("field")`

**Readability**
- Break complex queries into multiple steps
- Use variables with `as $var` for clarity
- Add comments in shell scripts
- Format multi-line jq programs for readability

## Common Patterns

For task-shaped recipes (API response processing, config extraction/merge, log analysis, CSV ↔ JSON transformation), open [references/common-patterns.md](references/common-patterns.md).

## Troubleshooting

When jq reports a parse error, returns nothing, raises a type error, or is slow on a large file, open [references/troubleshooting.md](references/troubleshooting.md).

## Integration with Other Tools

```bash
# With curl (API calls)
curl -s "https://api.github.com/users/octocat" | jq '.name, .bio'

# With gh CLI (GitHub operations)
gh api repos/owner/repo/issues | jq '.[] | {number, title, state}'

# With find (batch processing)
find . -name "package.json" -exec jq '.version' {} \;

# With xargs (parallel processing)
cat urls.txt | xargs -I {} curl -s {} | jq '.data'

# With yq (YAML to JSON conversion)
yq eval -o=json file.yaml | jq '.specific.field'
```

## Quick Reference

### Operators
- `.field` - Access field
- `.[]` - Iterate array/object
- `|` - Pipe (chain operations)
- `,` - Multiple outputs
- `?` - Optional (suppress errors)
- `//` - Alternative operator (default value)

### Functions
- `keys`, `values` - Object keys/values
- `length` - Array/object/string length
- `map()`, `select()` - Array operations
- `sort`, `sort_by()` - Sorting
- `group_by()` - Grouping
- `unique` - Remove duplicates
- `add` - Sum numbers or concatenate
- `has()` - Check field existence
- `type` - Get value type

### Type Conversions
- `tostring`, `tonumber` - Convert types
- `@csv`, `@tsv`, `@json` - Format output
- `split()`, `join()` - String/array conversion

## Installation

```bash
# macOS (Homebrew)
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

# Verify installation
jq --version
```

## Resources

- **Official Manual**: https://stedolan.github.io/jq/manual/
- **jq Playground**: https://jqplay.org/
- **Tutorial**: https://stedolan.github.io/jq/tutorial/

© laurigates · MIT · laurigates/claude-plugins

Похожие скиллы

Все скиллы по теме «Данные и базы» →
json-data-handling bobmatnyc Скилл json-data-handling обучает ИИ-агента безопасной работе с JSON в Python и JavaScript: сериализации дат, обходу циклических ссылок, валидации схем и потоковому чтению больших файлов. CX Codex +1 402установок data-processing-ray-data Orchestra Research Скилл data-processing-ray-data для Claude Code, который подключает Ray Data к задачам машинного обучения. Обрабатывает Parquet, CSV, JSON и изображения потоково, без загрузки всего датасета в память. CX Codex +1 134установок data-processing-nemo-curator Orchestra Research Скилл data-processing-nemo-curator помогает настроить конвейер очистки обучающих выборок для нейросетей через библиотеку NeMo Curator на видеокартах NVIDIA. CX Codex +1 123установок CSV to JSON Converter — Auto-Detect Delimiter axel-belfort CSV to JSON Converter — Auto-Detect Delimiter — MCP-сервер для Claude Code, преобразующий CSV в JSON с автоматическим определением разделителя. Распознаёт заголовки и выводит типизированные данные с метаданными парсинга. CX Codex +1 3 562установок jev okooo5km(十里) Запускает CLI jev и получает быстрые типизированные вердикты без рассуждений. Вердиктами сортирует, фильтрует и маршрутизирует данные перед дорогими вызовами LLM. CX Codex +1 642установок json-schema-lookup sammcj Скилл json-schema-lookup учит агента искать схемы конфигов популярных проектов в каталоге SchemaStore и проверять по ним структуру файлов. CX Codex +1 ★ 173звёзд репо

Из того же набора27

Весь набор →
uv-python-versions Скилл uv-python-versions помогает управлять версиями CPython и PyPy через uv: устанавливать интерпретаторы, закреплять версию проекта и переключаться между ними. CX Codex +1 332установок uv-advanced-dependencies Скилл uv-advanced-dependencies для работы с нестандартными источниками зависимостей в uv: репозиториями на GitHub, локальными пакетами в режиме редактирования, приватными индексами. CX Codex +1 332установок uv-tool-management Скилл uv-tool-management для Claude Code управляет глобальными Python CLI-утилитами через uv и запускает их без установки. Заменяет pipx и работает с ruff и pytest. CX Codex +1 328установок imagemagick-conversion Скилл imagemagick-conversion для Claude Code пакетно преобразует, масштабирует и оптимизирует изображения через ImageMagick в командной строке. Конвертирует форматы, создаёт миниатюры и обрабатывает сотни файлов за раз. CX Codex +1 260установок python-development Скилл python-development даёт агенту идиомы Python 3.10+: подсказки типов, match, asyncio, отладку. Полезен, когда правите библиотечный код или разбираете чужой. CX Codex +1 192установок generate-image Скилл generate-image генерирует изображения из текстового описания через модель Gemini 3 Pro Image, работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 177установок justfile-expert Скилл justfile-expert для Claude Code создаёт и правит Justfile: описывает рецепты, параметры, зависимости и модули. Настраивает команды проекта и автоматизацию задач. CX Codex +1 162установок git-commit-workflow Скилл git-commit-workflow для Claude Code задаёт формат сообщений и правила staging. Помогает разделять изменения по смыслу и не смешивать файлы в одном коммите. CX Codex +1 161установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой