Jsonpretty

Format, validate, query, flatten, and analyze JSON data. Use when asked to pretty-print JSON, validate JSON syntax, query nested JSON with dot-notation, flat...

Security Scan

The skill is internally consistent: it provides a pure-Python JSON utility, requires no credentials or external installs, and its instructions match the included code.

Purpose & Capability

Name/description (format, validate, query, flatten, stats) matches the code and SKILL.md. The skill only requires Python to run and reads JSON from a file or stdin, which is appropriate for the stated purpose.

Instruction Scope

SKILL.md instructs running the provided Python script against a file or stdin and lists feature flags (validate, query, flat, stats, compact, sort). The runtime instructions do not ask the agent to read unrelated files, environment variables, or transmit data to external endpoints.

Install Mechanism

There is no install spec. The skill is instruction-only / script-based and uses only the local Python interpreter and standard library; nothing is downloaded or written to disk beyond the included files.

Credentials

No environment variables, credentials, or config paths are required. The skill does not request broad secrets or unrelated tokens.

Persistence & Privilege

always is false and the skill does not request persistent system privileges or modify other skills or system-wide settings. It only runs the provided script when invoked.

Assessment

This appears to be a simple, self-contained JSON utility. Before installing or running it, ensure you have Python3 available and be mindful about pointing it at sensitive files (it will read any file path you provide). Note: the repository contains the same script in two locations (root and scripts/), which is harmless but redundant. Also be aware that some query paths may raise exceptions on malformed paths (this is a usability bug, not a security issue). If you need production guarantees, consider auditing behavior on very large or deeply nested JSON to avoid memory/stack issues.

JSON swiss army knife — format, validate, query, flatten, stats.

Commands

# Pretty-print (from file or stdin)
python3 scripts/jsonpretty.py data.json
echo '{"a":1}' | python3 scripts/jsonpretty.py

# Validate JSON
python3 scripts/jsonpretty.py --validate data.json

# Query with dot-notation
echo '{"user":{"name":"Rogue"}}' | python3 scripts/jsonpretty.py -q "user.name"

# Flatten nested JSON
cat data.json | python3 scripts/jsonpretty.py --flat

# Structure stats (key count, depth, types, size)
python3 scripts/jsonpretty.py --stats data.json

# Compact output (minify)
python3 scripts/jsonpretty.py --compact data.json

# Sort keys
python3 scripts/jsonpretty.py --sort data.json

Features

• Pretty-print with 2-space indent (default)
• JSON validation with error messages
• Dot-notation querying (supports array indices: key[0].sub)
• Flatten nested objects to key.subkey = value pairs
• Structure statistics: key count, nesting depth, type distribution, byte size
• Compact/minify mode
• Sorted key output
• Reads from file or stdin