Data Processing

Documents

data-processing

Data Processing is an Agent Skill for documents published in the aiskillstore/marketplace repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Process JSON with jq and YAML/TOML with yq. Filter, transform, query structured data efficiently. Triggers on: parse JSON, extract from YAML, query config, Docker Compose, K8s manifests, GitHub Actions workflows, package.json, filter data.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/aiskillstore/marketplace/blob/HEAD/skills/0xdarkmatter/data-processing/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/data-processing, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Data Processing

Query, filter, and transform structured data (JSON, YAML, TOML) efficiently from the command line.

Tools

Tool	Command	Use For
jq	`jq '.key' file.json`	JSON processing
yq	`yq '.key' file.yaml`	YAML/TOML processing

jq Essentials

# Extract single field
jq '.name' package.json

# Extract nested field
jq '.scripts.build' package.json

# Extract from array
jq '.dependencies[0]' package.json

# Extract multiple fields
jq '{name, version}' package.json

# Navigate deeply nested
jq '.data.users[0].profile.email' response.json

# Filter by condition
jq '.users[] | select(.active == true)' data.json

# Transform each element
jq '.users | map({id, name})' data.json

# Count elements
jq '.users | length' data.json

# Raw string output
jq -r '.name' package.json

yq Essentials

# Extract field
yq '.name' config.yaml

# Extract nested
yq '.services.web.image' docker-compose.yml

# List all keys
yq 'keys' config.yaml

# List all service names (Docker Compose)
yq '.services | keys' docker-compose.yml

# Get container images (K8s)
yq '.spec.template.spec.containers[].image' deployment.yaml

# Update value (in-place)
yq -i '.version = "2.0.0"' config.yaml

# TOML to JSON
yq -p toml -o json '.' config.toml

Quick Reference

Task	jq	yq
Get field	`jq '.key'`	`yq '.key'`
Array element	`jq '.[0]'`	`yq '.[0]'`
Filter array	`jq '.[] \| select(.x)'`	`yq '.[] \| select(.x)'`
Transform	`jq 'map(.x)'`	`yq 'map(.x)'`
Count	`jq 'length'`	`yq 'length'`
Keys	`jq 'keys'`	`yq 'keys'`
Pretty print	`jq '.'`	`yq '.'`
Compact	`jq -c`	`yq -o json -I0`
Raw output	`jq -r`	`yq -r`
In-place edit	-	`yq -i`

When to Use

Reading package.json dependencies
Parsing Docker Compose configurations
Analyzing Kubernetes manifests
Processing GitHub Actions workflows
Extracting data from API responses
Filtering large JSON datasets
Config file manipulation
Data format conversion

Additional Resources

For complete pattern libraries, load:

./references/jq-patterns.md - Arrays, filtering, transformation, aggregation, output formatting
./references/yq-patterns.md - Docker Compose, K8s, GitHub Actions, TOML, YAML modification
./references/config-files.md - package.json, tsconfig, eslint/prettier patterns