skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
netresearch/data-tools-skill94 installs

data-tools

Use when querying, transforming, filtering, converting, or editing ANY JSON, JSONL, YAML, TOML, XML, or CSV. MUST replace grep/sed/awk on structured formats.

How do I install this agent skill?

npx skills add https://github.com/netresearch/data-tools-skill --skill data-tools
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubwarn

    The skill provides a robust set of tools for processing structured data (JSON, YAML, CSV, etc.) and includes a hook to prevent the use of fragile text-processing tools. However, it explicitly teaches a pattern for extracting shell scripts from YAML configuration files and executing them, which constitutes dynamic code execution.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerfail

    3/5 files flagged

  • ZeroLeakspass

    Score: 93/100 · 2 sections analyzed

What does this agent skill do?

Data Tools Skill

Critical Rule

NEVER use grep, sed, awk, or inline interpreters (python3 -c, node -e) on JSON, JSONL, YAML, TOML, XML, or CSV. Refuse and use the correct tool — text tools break on structure; inline scripts are verbose and fragile.


Key Patterns

For the general legacy-tool → modern-tool comparison (grep→rg, find→fd, cat→bat, ...), see the cli-tools skill's table.

Convert: dasel -w FORMAT or yq -o FORMAT.

jq -- JSON (no in-place)

jq -r '.version' package.json
jq '.users[] | select(.role == "admin") | .name' users.json
jq '.version = "2.0.0"' pkg.json > pkg.json.tmp && mv pkg.json.tmp pkg.json
jq -s '.[0] * .[1]' base.json override.json

Or gh --jq when the source is the GitHub CLI (see below) — no separate jq process needed.

yq -- YAML (in-place -i)

yq '.services.web.image' docker-compose.yml
yq -i '.services.app.image = "node:20"' docker-compose.yml
yq -o json config.yml

dasel -- TOML (only native tool) / XML (or xmlstarlet for XPath) / Universal auto-detect

dasel -f Cargo.toml '.package.version'
dasel put -f config.toml -t string -v "2.0" '.project.version'
dasel -f input.json -w yaml

qsv -- CSV / TSV

qsv headers data.csv && qsv stats data.csv --everything | qsv table
qsv search -s status "active" users.csv | qsv select name,email
qsv join user_id orders.csv id users.csv

qsv index, stats and frequency write files next to the input (x.csv.idx, x.stats.csv*). In a repository or a package directory, run them on a copy (details).

mlr -- JSONL / multi-format / DSL (in-place -I)

mlr --c2j cat data.csv
mlr --jsonl filter '$level == "error"' logs.jsonl
mlr -I --csv put '$total = $qty * $price' orders.csv

GitHub CLI -- always --jq

gh api repos/owner/repo/releases/latest --jq '.tag_name'
gh pr list --json number,title --jq '.[] | [.number, .title] | @tsv'

Anti-Patterns

# BAD → GOOD: jq -r '.version' package.json
grep '"version"' package.json | sed 's/.*"\(.*\)".*/\1/'
# BAD → GOOD: yq -i '.services.app.image = "node:20"' compose.yml
sed -i 's/image: node:.*/image: node:20/' docker-compose.yml
# BAD → GOOD: qsv select 2 data.csv
awk -F',' '{print $2}' data.csv
# BAD → GOOD: jq -r '.version' plugin.json
python3 -c 'import json;print(json.load(open("plugin.json"))["version"])'

References

CookbookContent
jq CookbookFiltering, transforms, GitHub CLI, large inputs ("Argument list too long", Windows)
yq CookbookActions, Compose, K8s
dasel CookbookTOML/XML, conversion
CSV Processingqsv workflows, joins
mlr CookbookJSONL, DSL, stats, joins
Enforcement HookPreToolUse gate shipped with this plugin: denies field extraction, warns once otherwise

Docs: jq, yq, dasel, qsv, mlr.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/netresearch/data-tools-skill/data-tools">View data-tools on skillZs</a>