Jsonpath Query

Query JSON data using JSONPath expressions. Use when asked to extract, filter, search, or navigate JSON data. Supports recursive descent, wildcards, array sl...

Security Scan

The skill is a self-contained, pure-Python JSONPath query tool whose code and instructions align with its stated purpose and do not request credentials or perform network I/O.

Purpose & Capability

Name/description match the provided code and SKILL.md examples. The script implements JSONPath parsing, querying, path discovery, and output formatting; no unrelated capabilities (cloud access, secrets, etc.) are requested.

Instruction Scope

Runtime instructions only show running the included script on stdin or a named file with JSONPath expressions. The script only reads JSON from stdin or a user-specified file and writes results to stdout/stderr — it does not access other system files, environment variables, or external endpoints.

Install Mechanism

No install spec is provided (instruction-only). The included code is pure Python using only the standard library; nothing is downloaded or executed from external URLs.

Credentials

The skill declares no required environment variables, credentials, or config paths and the code does not read env vars or require secrets. The requested privileges are proportional to a local JSON query utility.

Persistence & Privilege

always is false and the skill is user-invocable. It does not modify other skills or system-wide configuration and does not request persistent presence or elevated privileges.

Assessment

This skill is a local JSONPath CLI implemented in pure Python and appears to do only what it says: read JSON from stdin or a file and print query results. It does not require credentials or perform network I/O. Before installing, you may: review the included scripts/jsonpath.py (it is small and uses only the stdlib), avoid piping highly sensitive secrets into any third-party tool unless you trust the author, and be mindful of very large JSON inputs which could use lots of memory/CPU.

JSONPath Query Tool

Query JSON data using JSONPath expressions with recursive descent, wildcards, filters, and slicing.

Query

# From file
python3 scripts/jsonpath.py query '$.store.book[0].title' -f data.json

# From stdin
cat data.json | python3 scripts/jsonpath.py query '$.store.book[*].author'

# Recursive descent (find all 'name' fields at any depth)
cat data.json | python3 scripts/jsonpath.py query '$..name'

# Array slicing
cat data.json | python3 scripts/jsonpath.py query '$.items[0:5]'

# Filter (price < 10)
cat data.json | python3 scripts/jsonpath.py query '$.store.book[?(@.price < 10)]'

# Wildcard
cat data.json | python3 scripts/jsonpath.py query '$.store.*'

# Count matches
cat data.json | python3 scripts/jsonpath.py query '$.users[*]' --count

# First match only
cat data.json | python3 scripts/jsonpath.py query '$.items[*].id' --first

# Exit 1 if no matches (CI-friendly)
cat data.json | python3 scripts/jsonpath.py query '$.missing' --exit-empty

List Paths

# Show all available paths in JSON data
cat data.json | python3 scripts/jsonpath.py paths

# Limit depth
cat data.json | python3 scripts/jsonpath.py paths --depth 3

Extract Multiple Values

# Named extractions
cat data.json | python3 scripts/jsonpath.py extract 'name=$.user.name' 'emails=$.user.emails[*]'

Validate Expression

python3 scripts/jsonpath.py validate '$.store.book[?(@.price > 10)]'

Output Formats

python3 scripts/jsonpath.py query '$.items[*]' -f data.json --format json    # default
python3 scripts/jsonpath.py query '$.items[*].id' -f data.json --format lines # one per line
python3 scripts/jsonpath.py query '$.items[*]' -f data.json --format csv      # CSV for objects

JSONPath Syntax

Expression	Description
$	Root object
.key	Child key
[0]	Array index
[0:5]	Array slice (start:end)
[0:10:2]	Array slice with step
[*]	All elements
..key	Recursive descent
[?(@.price<10)]	Filter expression
['key']	Bracket notation
[0,1,2]	Union (multiple indices)