data-processing skill
Query, filter, and transform structured JSON, YAML, and TOML data using command-line tools.
- GitHub stars
- 81
- Files
- 6
- Last commit
- Nov 7, 2026
- License
- MIT
- Allowed tools
- 2
What does the data-processing skill do?
data-processing is an agent skill. Query, filter, and transform structured JSON, YAML, and TOML data using command-line tools.
Summary generated from the skill's SKILL.md.
About the data-processing skill
Extracting specific values from configuration files and API responses is what this skill enables for developers working with structured data. By loading this skill, an agent gains the ability to query, filter, and transform JSON, YAML, and TOML files using the jq and yq command-line tools. It is particularly useful when an agent needs to inspect package.json dependencies, parse Docker Compose files, or analyze Kubernetes manifests and GitHub Actions workflows.
The skill relies on the Bash Read tool and requires the jq and yq CLI tools to be installed on the host system. It produces precise data extractions, such as nested fields from deep JSON structures or specific container images from Kubernetes deployment files. Unlike simple text reading, this tool allows for complex operations like in-place updates of YAML files with yq, converting TOML to JSON, or filtering large datasets based on specific conditions using jq selectors.
What an agent can do with it
- 1Extracting package dependenciesRetrieve specific fields or nested scripts from a package.json file.
- 2Inspecting container configurationsIdentify container images within a Kubernetes deployment manifest.
- 3Modifying configuration filesUpdate a version number directly within a YAML configuration file.
- 4Filtering large datasetsSelect only the active users from a large JSON data file.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the data-processing skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the data-processing skill in Plugin
/plugin marketplace add 0xDarkMatter/claude-mods /plugin install claude-mods@claude-mods
Install the data-processing skill in Claude Code
~/.claude/skills/data-processing/SKILL.md
$ npx degit 0xDarkMatter/claude-mods/skills/data-processing ~/.claude/skills/data-processingInstall the data-processing skill in Claude Code (project)
.claude/skills/data-processing/SKILL.md
$ npx degit 0xDarkMatter/claude-mods/skills/data-processing .claude/skills/data-processingInstall the data-processing skill in Codex
~/.agents/skills/data-processing/SKILL.md
$ npx degit 0xDarkMatter/claude-mods/skills/data-processing ~/.agents/skills/data-processingInstall the data-processing skill in Gemini CLI
~/.gemini/skills/data-processing/SKILL.md
$ npx degit 0xDarkMatter/claude-mods/skills/data-processing ~/.gemini/skills/data-processingInstall the data-processing skill in Claude.ai
npx degit 0xDarkMatter/claude-mods/skills/data-processing data-processing && zip -r data-processing.zip data-processing # claude.ai → Customize → Skills → + → Create skill → Upload a skill → data-processing.zip
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A skill needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachable0xdarkmatter/claude-mods/skills/data-processing is public and reachablegithub.com/0xdarkmatter/claude-mods/tree/HEAD/skills/data-pr ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-07github.com/0xdarkmatter/claude-mods/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/0xdarkmatter/claude-mods/blob/HEAD/skills/data-pr ↗Pass
- Pre-approved tools are scopedBash lets the agent run any shell command without askinggithub.com/0xdarkmatter/claude-mods/blob/HEAD/skills/data-pr ↗Finding
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 111 linesgithub.com/0xdarkmatter/claude-mods/blob/HEAD/skills/data-pr ↗Pass
SKILL.md
View on GitHubData 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
Files in this skill
6data-processing skill questions
How do I install the data-processing skill in Claude Code?
Run npx degit 0xDarkMatter/claude-mods/skills/data-processing ~/.claude/skills/data-processing. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the data-processing skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
What tools are required to use this skill?
You must have the jq and yq CLI tools installed on your system.
Can I perform in-place edits with these tools?
Yes, yq supports in-place updates using the -i flag.
Can I convert TOML files to JSON?
Yes, you can use yq to parse TOML and output it as JSON.