Agent skill

Jq JSON Processor

by penpot in penpot/penpot

Process, filter, and transform JSON data using jq - the lightweight and flexible command-line JSON processor.

MPL-2.0Auto-check passed

Install Jq JSON Processor

skills CLI
$ npx skills add penpot/penpot --skill jq-json-processor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install penpot/penpot jq-json-processor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/penpot/penpot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/jq-json-processor .claude/skills/jq-json-processor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
jq-json-processor
GitHub stars
61k
Token cost
~663 tokens
SKILL.md length
104 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MPL-2.0

At a glance

Process, filter, and transform JSON data using jq - the lightweight and flexible command-line JSON processor.

  • SKILL.md covers When to use, Quick Examples, Common Use Cases and Tips, plus 1 more section
  • Calls jq and curl; reaches api.github.com

What it does

Jq JSON Processor is an agent skill from penpot/penpot. Process, filter, and transform JSON data using jq - the lightweight and flexible command-line JSON processor.

Its SKILL.md is about 660 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Penpot: The open-source design platform for Product teams that need scalable collaboration. The licence is MPL-2.0.

Example prompts

  • “/jq-json-processor”

What it can do on your machine

Read from SKILL.md and the folder at commit cb1118f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.github.com

    Also links to:

    • jqlang.github.io
    • jqplay.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Jq JSON Processor loads about 663 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 104 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~663

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from penpot/penpot at commit cb1118f, republished under its MPL-2.0 licence (© penpot). 104 words, ~663 tokens.

Download SKILL.mdSave it as .claude/skills/jq-json-processor/SKILL.md (or your agent's skills folder).
name
jq-json-processor
description
Process, filter, and transform JSON data using jq - the lightweight and flexible command-line JSON processor.
homepage
https://jqlang.github.io/jq/

jq JSON Processor

Process, filter, and transform JSON data with jq.

When to use

  • Parsing, filtering, or transforming JSON from commands, files, or API responses — slicing, reshaping, or validating JSON output.

Quick Examples

Basic filtering
bash
# Extract a field
echo '{"name":"Alice","age":30}' | jq '.name'
# Output: "Alice"

# Multiple fields
echo '{"name":"Alice","age":30}' | jq '{name: .name, age: .age}'

# Array indexing
echo '[1,2,3,4,5]' | jq '.[2]'
# Output: 3
Working with arrays
bash
# Map over array
echo '[{"name":"Alice"},{"name":"Bob"}]' | jq '.[].name'
# Output: "Alice" "Bob"

# Filter array
echo '[1,2,3,4,5]' | jq 'map(select(. > 2))'
# Output: [3,4,5]

# Length
echo '[1,2,3]' | jq 'length'
# Output: 3
Common operations
bash
# Pretty print JSON
cat file.json | jq '.'

# Compact output
cat file.json | jq -c '.'

# Raw output (no quotes)
echo '{"name":"Alice"}' | jq -r '.name'
# Output: Alice

# Sort keys
echo '{"z":1,"a":2}' | jq -S '.'
Advanced filtering
bash
# Select with conditions
jq '[.[] | select(.age > 25)]' people.json

# Group by
jq 'group_by(.category)' items.json

# Reduce
echo '[1,2,3,4,5]' | jq 'reduce .[] as $item (0; . + $item)'
# Output: 15
Working with files
bash
# Read from file
jq '.users[0].name' users.json

# Multiple files
jq -s '.[0] * .[1]' file1.json file2.json

# Modify and save
jq '.version = "2.0"' package.json > package.json.tmp && mv package.json.tmp package.json

Common Use Cases

Extract specific fields from API response:

bash
curl -s https://api.github.com/users/octocat | jq '{name: .name, repos: .public_repos, followers: .followers}'

Convert CSV-like data:

bash
jq -r '.[] | [.name, .email, .age] | @csv' users.json

Debug API responses:

bash
curl -s https://api.example.com/data | jq '.'

Tips

  • Use -r for raw string output (removes quotes)
  • Use -c for compact output (single line)
  • Use -S to sort object keys
  • Use --arg name value to pass variables
  • Pipe multiple jq operations: jq '.a' | jq '.b'

Documentation

Full manual: https://jqlang.github.io/jq/manual/ Interactive tutorial: https://jqplay.org/

© penpot, MPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/jq-json-processor of penpot/penpot.

Open the folder on GitHubat commit cb1118f

Compare with similar skills

Jq JSON Processor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Jq JSON Processor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Jq JSON Processor this skillpenpot/penpot61k—~663Automated safety check: PassMPL-2.0
TransformersK-Dense-AI/scientific-agent-skills48k1 repos~2.8kAutomated safety check: NotesApache-2.0
Filterzalando/skipper3.3k—~527Automated safety check: PassMIT
Hugging Face Transformers Usagedavila7/claude-code-templates32k12 repos~1.2kAutomated safety check: PassMIT
Transformers JSsickn33/agentic-awesome-skills47k1 repos~444Automated safety check: PassApache-2.0
Testing Core Processorsmastra-ai/mastra29k—~1.1kAutomated safety check: PassCustom licence

Similar skills

  • Transformers

    K-Dense-AI/scientific-agent-skills

    Hugging Face Transformers for loading Hub models, running pipeline inference, text generation, and Trainer fine-tuning on NLP, vision, audio, and multimodal tasks.

    48k GitHub starsUsed in 1 repo~2.8k tokens
    AI & LLM EngineeringAuto-check: notes
  • Filter

    zalando/skipper

    Create or modify code in the filters package and all its sub-folders

    3.3k GitHub stars~527 tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Hugging Face Transformers Usage

    davila7/claude-code-templates

    Loads pre-trained Hugging Face Transformers models for text, vision and audio tasks, runs inference with pipelines and fine-tunes on custom datasets.

    32k GitHub starsUsed in 12 repos~1.2k tokens
    AI & LLM EngineeringAuto-check passed
  • Transformers JS

    sickn33/agentic-awesome-skills

    Use Transformers.js to run state-of-the-art machine learning models directly in JavaScript/TypeScript.

    47k GitHub starsUsed in 1 repo~444 tokens
    AI & LLM EngineeringAuto-check passed
  • Testing Core Processors

    mastra-ai/mastra

    A skill your agent uses when writing or debugging integration tests for error processors in packages/core/src/processors/.

    29k GitHub stars~1.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Fp Data Transforms

    sickn33/agentic-awesome-skills

    Everyday data transformations using functional patterns - arrays, objects, grouping, aggregation, and null-safe access

    47k GitHub starsUsed in 2 repos~2.4k tokens
    Data & AnalyticsAuto-check passed

More from penpot/penpot

All 24 skills in this repo
  • Hardens code against vulnerabilities. An agent skill from penpot/penpot.

    61k GitHub starsUsed in 6 repos~4.7k tokens
    Auto-check: notes
  • Bat Cat

    penpot/penpot

    A cat clone with syntax highlighting, line numbers, and Git integration - a modern replacement for cat.

    61k GitHub starsUsed in 3 repos~1.1k tokens
    Auto-check passed
  • Create PR

    penpot/penpot

    PR flow — open a new PR for the current task branch (validates base branch, commits, issue and push state) or update an existing PR's title or description to match Penpot conventions.

    61k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Local CI

    penpot/penpot

    Run local CI-style checks with ./scripts/ci (lint, tests, format) per monorepo module.

    61k GitHub stars~822 tokensUpdated today
    Auto-check passed
  • Ste

    penpot/penpot

    Write or rewrite text in ASD-STE100 Simplified Technical English.

    61k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Code review criteria — the five review axes, core principles, severity format, and verdict for reviewing code changes.

    61k GitHub stars~3.6k tokensUpdated today
    Auto-check passed

Questions about Jq JSON Processor

What does Jq JSON Processor do?

Process, filter, and transform JSON data using jq - the lightweight and flexible command-line JSON processor. Jq JSON Processor is an agent skill from penpot/penpot. Process, filter, and transform JSON data using jq - the lightweight and flexible command-line JSON processor.

How do I install Jq JSON Processor in Claude Code?

Run `npx skills add penpot/penpot --skill jq-json-processor -a claude-code`. Or copy the skill folder (.agents/skills/jq-json-processor in penpot/penpot) into .claude/skills/jq-json-processor in your project. Claude Code loads it when a task matches its description.

How do I install Jq JSON Processor in Codex?

Run `npx skills add penpot/penpot --skill jq-json-processor -a codex`. Or copy the skill folder (.agents/skills/jq-json-processor in penpot/penpot) into .agents/skills/jq-json-processor in your project. Codex loads it when a task matches its description.

Can I use Jq JSON Processor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add penpot/penpot --skill jq-json-processor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/jq-json-processor, .gemini/skills/jq-json-processor, .github/skills/jq-json-processor and .opencode/skills/jq-json-processor in your project.

What does Jq JSON Processor need to run?

Going by SKILL.md and its folder, Jq JSON Processor needs the command-line tools its instructions call (jq and curl).

Does Jq JSON Processor access the network?

SKILL.md names 3 domains. In commands or code: api.github.com; the agent is likely to contact it when it follows the instructions. As links in the text: jqlang.github.io and jqplay.org. This is read from the text; nothing was executed.

Is Jq JSON Processor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Jq JSON Processor use?

Jq JSON Processor is published under the MPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Jq JSON Processor use?

About 663 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Jq JSON Processor?

Skills that share tags, products or a category with Jq JSON Processor: Transformers (K-Dense-AI/scientific-agent-skills, 48k stars), Filter (zalando/skipper, 3.3k stars), Hugging Face Transformers Usage (davila7/claude-code-templates, 32k stars) and Transformers JS (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Jq JSON Processor?

penpot (a GitHub organization) maintains it in penpot/penpot, which has 60,798 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 7, 2026.

Source: penpot/penpot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.