json-pipe

Pipe JSON between shell commands using jq-lite for transformation steps. Use when building shell pipelines that process JSON data through multiple transformation stages. Triggers include "pipe JSON", "shell pipeline JSON", "curl | jql", "transform JSON in pipeline", "chain JSON operations".

7 stars

Best use case

json-pipe is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Pipe JSON between shell commands using jq-lite for transformation steps. Use when building shell pipelines that process JSON data through multiple transformation stages. Triggers include "pipe JSON", "shell pipeline JSON", "curl | jql", "transform JSON in pipeline", "chain JSON operations".

Teams using json-pipe should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/json-pipe/SKILL.md --create-dirs "https://raw.githubusercontent.com/heldernoid/agentic-build-templates/main/projects/cli-tools/jq-lite/skills/json-pipe/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/json-pipe/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How json-pipe Compares

Feature / Agentjson-pipeStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Pipe JSON between shell commands using jq-lite for transformation steps. Use when building shell pipelines that process JSON data through multiple transformation stages. Triggers include "pipe JSON", "shell pipeline JSON", "curl | jql", "transform JSON in pipeline", "chain JSON operations".

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# json-pipe

Pattern guide for chaining jql in shell pipelines.

## Common Pipeline Patterns

### curl -> extract -> use

```bash
# Get GitHub stars
curl -s https://api.github.com/repos/nodejs/node | jql -r '.stargazers_count'

# Get all repo names
curl -s https://api.github.com/users/octocat/repos | jql -r '.[].name'

# Get environment variable from k8s secret
kubectl get secret myapp-env -o json | jql -r '.data.DATABASE_URL' | base64 -d
```

### filter -> format -> save

```bash
cat events.json | jql '.events[] | select(.level == "error")' > errors.json
cat users.json | jql --csv '.users' > users.csv
cat config.json | jql --compact '.' > config.min.json
```

### transform -> pipe to next tool

```bash
# Extract emails, send notifications
cat users.json | jql -r '.users[] | select(.active) | .email' | xargs -I{} mail -s "Update" {}

# Get running container IDs
docker ps -q | xargs docker inspect | jql -r '.[].Name' | sed 's/^\///'
```

### NDJSON log processing

```bash
# Count errors in log
cat app.log | jql 'select(.level == "error")' | wc -l

# Extract error messages
cat app.log | jql -r 'select(.level == "error") | .msg'

# Top error types
cat app.log | jql 'select(.level == "error") | .type' | sort | uniq -c | sort -rn
```

## Tips

- Use `-r` (raw) when passing string values to other shell commands.
- Use `-c` (compact) when storing JSON in shell variables: `X=$(cat f.json | jql -c '.field')`
- NDJSON (one JSON per line) is processed line by line - safe for large log files.
- Errors go to stderr; safe to pipe stdout to other commands even on parse errors.

Related Skills

Skill: JSON log parsing

7
from heldernoid/agentic-build-templates

## When to use

json-differ

7
from heldernoid/agentic-build-templates

Compare two JSON blobs and view structural and value differences. Use when you need to compare API responses, config files, database records, or any two JSON objects. Triggers include "compare JSON", "JSON diff", "what changed", "JSON differences", "diff two objects", or any task involving comparing JSON data.

data-pipeline-monitor

7
from heldernoid/agentic-build-templates

Track ETL and data pipeline jobs with success/failure status, duration tracking, heartbeat monitoring, and dependency visualization. Use when you need to monitor scheduled jobs, detect failures, track pipeline health over time, or visualize ETL step dependencies. Triggers include "pipeline monitoring", "job tracking", "ETL status", "cron job health", "heartbeat monitor", "pipeline failed", or any task involving monitoring data workflows.

jsonl-format

7
from heldernoid/agentic-build-templates

JSONL format guide for LLM fine-tuning. Covers OpenAI, Anthropic, and Llama formats, format validation rules, conversion between formats, and quality checklist.

Skill: Uptime Monitoring

7
from heldernoid/agentic-build-templates

## Overview

Skill: Status Page

7
from heldernoid/agentic-build-templates

## Overview

Skill: unit-conversion

7
from heldernoid/agentic-build-templates

## Overview

Skill: recipe-scaler

7
from heldernoid/agentic-build-templates

## Overview

reading-list

7
from heldernoid/agentic-build-templates

Operate the reading-list API to save, manage, tag, search, and export articles.

email-digest

7
from heldernoid/agentic-build-templates

Configure, test, and troubleshoot the reading-list daily email digest delivered via nodemailer.

websocket-realtime

7
from heldernoid/agentic-build-templates

Use the WebSocket connection in poll-builder to receive live vote updates. Use when you need to stream real-time poll results, monitor a poll for new votes, or build a live dashboard. Triggers include "live results", "real-time updates", "stream votes", "watch poll", or "WebSocket".

poll-builder

7
from heldernoid/agentic-build-templates

Self-hosted poll creation tool with real-time results. Use when you need to create a poll, check vote counts, close a poll, export results, or get the shareable link for a poll. Triggers include "create poll", "vote", "poll results", "survey", "collect votes", "share poll", or any task involving polling or voting.